@dybai/dsh-editor 0.8.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
@@ -40,7 +40,7 @@
40
40
  **保存与键位**:
41
41
 
42
42
  - `Ctrl+S` 保存前台编辑器;`Ctrl+Shift+S` 保存当前会话全部未保存的编辑器;`Ctrl+D` 删除光标行/选区触及行;`Ctrl+G` 打开跳转到行面板。这四条是**框架自管键位**:编辑器根元素拦截 keydown 并自行 `preventDefault`(对任何组合有效,不受 DSH web 快捷键白名单限制),编辑器之外浏览器默认行为照旧;
43
- - 键位是全局用户偏好:编辑器状态栏右端的小键盘图标打开键位面板,逐动作「录制」新组合(允许任何组合,含浏览器保留键)或「恢复默认」,持久化到 Host 存储、所有已挂载编辑器立即生效(详见 [docs/contracts.md](docs/contracts.md) §6);
43
+ - 键位是全局用户偏好:编辑器状态栏右端的**齿轮**打开设置中心的「快捷键」分区,逐动作「录制」新组合(允许任何组合,含浏览器保留键)或「恢复默认」,持久化到 Host 存储、所有已挂载编辑器立即生效(详见 [docs/contracts.md](docs/contracts.md) §6);
44
44
  - 磁盘文件被外部修改时出现冲突横幅:**重新加载并丢弃本地修改** 或 **仍要保存(覆盖磁盘)**;
45
45
  - 编辑中途崩溃/刷新后重新打开同一文件,未保存草稿自动恢复(磁盘文件也变过时先出冲突横幅,绝不静默覆盖)。
46
46
 
@@ -50,18 +50,18 @@
50
50
  - 文件被外部删除时,页签文件名标红并画上删除线,悬浮条询问是否关闭页签;选择保留可继续编辑,**Ctrl+S 保存即重建文件**(成功后红标消失)。外部同路径重建会被识别并清除红标;
51
51
  - 删除后**原样保存不需要先修改内容**:干净草稿下保存按钮/Ctrl+S 首次触发只布防确认(按钮变「确认重建」警示色),再次触发才执行重建;任何编辑或外部状态变化自动解除布防;
52
52
  - 检测走宿主 `workspaceFiles/changes` 推送流(实时、零轮询),流不可用时自动降级为切换回页面/窗口聚焦时检查;
53
- - 干净文件自动重载可在状态栏右端齿轮图标的**设置面板**中开启(默认关闭 = 一律询问),持久化到 Host 存储。
53
+ - 干净文件自动重载可在状态栏右端齿轮打开的**设置中心**(「行为」分区)中开启(默认关闭 = 一律询问),持久化到 Host 存储。
54
54
 
55
55
  **活动行高亮**(0.4.0):
56
56
 
57
57
  - 编辑区以光标所在行的上下细边线标记当前行(VS Code 风格,不填背景——为将来的语法高亮留出颜色空间),随光标移动、内容编辑与滚动实时跟随;多行选区时边线跟随光标端(拖拽释放所在行),选区本身由浏览器原生选区样式呈现,不逐行描边;
58
- - 设置面板新增「高亮光标所在行」开关(默认开,全局持久化,对所有已挂载编辑器立即生效);
58
+ - 设置中心「外观」分区新增「高亮光标所在行」开关(默认开,全局持久化,对所有已挂载编辑器立即生效);
59
59
  - 第三方模式可在描述符声明 `activeLine: true` 接入同一契约:经组件 prop `highlightActiveLine` 接收偏好、以快照 `selection.lineStart`/`lineEnd` 为高亮范围自行绘制(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
60
60
 
61
61
  **行号列**(0.5.0):
62
62
 
63
63
  - 编辑区内容左侧显示行号列:宽度随最大行号位数自适应(跨 100/1000 行等进位时自动加宽),随滚动、编辑、行导航实时同步;
64
- - 设置面板新增「显示行号」开关(默认开,全局持久化,对所有已挂载编辑器立即生效)。开关只控制数字显隐:分界竖线与左侧预留带常驻,切换不会移动正文位置;
64
+ - 设置中心「外观」分区新增「显示行号」开关(默认开,全局持久化,对所有已挂载编辑器立即生效)。开关只控制数字显隐:分界竖线与左侧预留带常驻,切换不会移动正文位置;
65
65
  - 无描述符声明字段:`showLineNumbers` 偏好经组件 prop 直接送达到每个挂载的模式组件,第三方模式可自行接入(绘制行号列)或安全忽略(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
66
66
 
67
67
  **跳转到行**(0.6.0):
@@ -69,7 +69,7 @@
69
69
  - `Ctrl+G` 打开跳转面板(状态栏 `Ln/Col` 指示器正上方的小输入面板),输入框默认置空并自动聚焦:输入行号后回车或点「跳转」即把光标定位到**目标行行首**(焦点随之回到编辑区),面板关闭;
70
70
  - 输入自动收敛到 `1–总行数`(越界取最近的有效行);空/非数字输入给出内联提示、不跳转;文件仍在加载时也允许输入,加载完成后延迟落点(`failed` 相位禁用跳转);
71
71
  - 面板关闭路径:跳转成功 / `Esc` / 点击面板外 / 页签转为不可见;
72
- - `Ctrl+G` 与其余三条一样可在键位面板「录制」改键;**旧版本已自定义过键位的用户升级后键位原样保留**,新增的跳转键按 `Ctrl+G → Ctrl+Shift+G → Ctrl+Alt+G` 候选链自动补位(默认键被占用时顺延),迁移只发生在读取侧、不改写已存储数据;
72
+ - `Ctrl+G` 与其余三条一样可在设置中心「快捷键」分区「录制」改键;**旧版本已自定义过键位的用户升级后键位原样保留**,新增的跳转键按 `Ctrl+G → Ctrl+Shift+G → Ctrl+Alt+G` 候选链自动补位(默认键被占用时顺延),迁移只发生在读取侧、不改写已存储数据;
73
73
  - 热键链路(派发/退避/解析/跳转/迁移)带 `[dsh-editor]` 前缀的 `console.debug` 日志,浏览器控制台勾选 verbose 即可定位每一步的状态。
74
74
 
75
75
  **光标与视口位置恢复**(0.8.0):
@@ -79,6 +79,53 @@
79
79
  - 显式导航优先:带 `line` 打开、`Ctrl+G` 跳转不会被旧位置覆盖;
80
80
  - 文件内容变短或行被删除时,位置收敛到当前文本的有效行;第三方编辑模式可经可选 props `initialScroll` / `onScrollChange` 接入滚动恢复(不接入也会恢复机器选区;模式需按契约镜像机器选区并让编辑区取得焦点,光标才可见)。
81
81
 
82
+ **滚动越过最后一行**(0.9.0):
83
+
84
+ - 编辑区内容末尾之后保留可滚动空白:底部空白区域可以滚到屏幕上方,滚到尽头时只剩最后一行贴在视口顶部(行号列与高亮条同步贴顶);短文件(含单行)同样生效;
85
+ - 设置中心「外观」分区新增「滚动越过最后一行」开关(默认开,全局持久化,对所有已挂载编辑器立即生效),关闭后恢复“最后一行贴底”的旧行为;
86
+ - 无描述符声明字段:`scrollBeyondLastLine` 偏好经组件 prop 直接送达到每个挂载的模式组件,管理自身滚动容器的第三方模式可自行接入或安全忽略(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
87
+
88
+ **自动换行**(0.10.0):
89
+
90
+ - `md` / `markdown` / `mdx` 文件默认折行,`txt`、`js` 等其余扩展名默认不折行(VS Code 同构);折行发生在**词边界**,只有超长单词/URL 才会被硬折(`overflow-wrap: break-word` 兜底);
91
+ - 设置中心「换行」分区新增「自动换行」开关:显示的是**全局显式值**(未设置时按钮显示「关」,并注明「未设置时按扩展名默认(md 系开)」);点击写入全局显式值,对所有文件立即生效。显式设置一旦存在,它对 md 与 txt 一视同仁地覆盖内置默认——需要「只改 md 不改 txt」时用同分区的「本类型换行」覆盖(0.11.0,见下节);
92
+ - 折行下三种定位全部保真:行号列逐行与逻辑行对位、活动行高亮只覆盖**光标所在的那个视觉行**(VS Code 风格:光标停在折行边界时算上一视觉行的行尾,多行选区本身仍由浏览器原生绘制)、`Ctrl+G` 与 End 键按视觉行精确落点;关闭换行立即回到 0.9.0 的水平不折行观感(滚动位置由浏览器按新范围钳制,无报错);
93
+ - 拖拽窗格宽度时行号先用近似估算顶上(不消失,数值可能短暂不准),松手约 200ms 后全量重测校准;数千行的大文件同样先出近似行号、测量推进中界面保持可交互,完成后自动对齐;
94
+ - 折行纯属显示层:文件里一个字符都不会被改写,保存回磁盘的仍是原始长行;
95
+ - 无描述符声明字段:`wordWrap` 偏好经组件 prop 直接送达到每个挂载的模式组件,管理自身折行的第三方模式可据此对齐用户意图,不支持的模式忽略即可(见 [docs/contracts.md](docs/contracts.md) §5.1 / §5.5)。
96
+
97
+ **设置中心与按类型换行**(0.11.0):
98
+
99
+ - 状态栏右端的**齿轮**是唯一设置入口:打开一个**应用级单例模态**设置中心(半透明遮罩 + 居中面板,左分区菜单 / 右内容滚动区),`Esc`、点击遮罩、右上角关闭按钮三种退出方式,关闭后焦点归还齿轮;单例意味着多个页签/会话共用同一个对话框,打开它的页签关掉后对话框仍可继续使用(换行分区只保留打开时的文件上下文用于展示);
100
+ - 四个分区:**外观**(高亮光标所在行 / 显示行号 / 滚动越过最后一行——行为与 0.10.0 的设置浮窗等价,切换对所有已挂载编辑器实时生效)、**行为**(干净文件自动重载)、**换行**(全局开关 + 本类型覆盖)、**快捷键**(原键位浮窗整体迁入:四动作录制 / 恢复默认 / 冲突与浏览器保留组合提示原样保留;录制中按 `Esc` 只取消录制、不关闭对话框);
101
+ - 按类型换行:换行分区多出「本类型换行」一行,按打开文件的扩展名显示 `*.md(main.md)` 这样的上下文,点击在 **跟随全局 → 强制开 → 强制关** 三态间循环并同时显示该类型的有效值;覆盖优先于全局显式设置(三层链:命中的 per-glob 覆盖 > 全局显式 > 内置扩展名默认),所以「md 折行、txt 不折行」这类按类型设定现在可以直接做;无扩展名的文件该行禁用(只有「跟随全局」可表达);
102
+ - 跨窗口实时生效:任一偏好写入成功后经 `BroadcastChannel` 广播(不可用时降级 localStorage 通知),其他窗口收到后立即重读全部偏好缓存并生效;窗口重新聚焦 / 页面恢复可见时再兜底刷新一次。双窗口同时改同一项由 Host 侧 CAS 拒绝后写者(提示后重读,不静默覆盖);
103
+ - 覆盖面与边界:外观 / 行为 / 换行作用于所有已挂载编辑器与之后新开的文件。第三方模式仍经组件 prop `wordWrap` 收到**当前文件的三层链最终值**,不感知层级(见 [docs/contracts.md](docs/contracts.md) §5.5 / §8);设置中心本身是纯 UI 演进,不新增第三方契约面(第三方设置分区座位本期不开放)。
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
+
82
129
  ## 集成接口摘要
83
130
 
84
131
  | 契约面 | 入口 | 一句话 |
@@ -99,6 +146,13 @@
99
146
  - `fs` 字节写 facet(当前仅整文件 UTF-8 文本写,≤4 MB,文本格式白名单);
100
147
  - 模式关联管理设置页(关联目前仅经模式菜单"设为默认/恢复默认"管理)。
101
148
 
149
+ 自动换行(0.10.0 引入,0.11.0 起为三层解析)的明确非目标(记录在案,去向已定):
150
+
151
+ - **4 MiB 编辑上限不随换行调整**:`MAX_EDIT_CHARS` / `MAX_CONTENT_CHARS` 是 textarea 预算,本版不动;与「大文件模式」一并解决;
152
+ - **无渐进分块测量(A2)**:本版只有挂载时的一轮有界初始化分块,不维护"部分精确"的常驻状态;与「大文件模式」一并解决(届时只换测量模块内部,查询接口与组件触点不变);
153
+ - **按类型覆盖只支持 `*.<ext>` 形态**:换行覆盖按扩展名后缀匹配(单段 `*` + 点 + 1–16 位小写字母/数字),不支持任意 minimatch glob(如 `src/**`、`*.test.*`)与按工作区/目录的作用域;任意 glob 随未来的覆盖管理 UI 一起 additive;
154
+ - **无 `Alt+Z` 式临时开关**:不能只对当前页签临时切换换行且不持久化;等真实需求出现再 additive。
155
+
102
156
  另有:只能编辑会话工作区内的文本文件;编辑器以独立 tab 打开,不替换当前预览 tab;键位录制会拒绝浏览器生命周期保留组合(Ctrl/⌘+W/T/N/Q、Ctrl+Tab 等)并给出提示——页面层无法可靠拦截这类浏览器默认行为。
103
157
 
104
158
  ## 契约变更记录