@dybai/dsh-editor 0.8.0 → 0.11.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,29 @@
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
+
82
105
  ## 集成接口摘要
83
106
 
84
107
  | 契约面 | 入口 | 一句话 |
@@ -99,6 +122,13 @@
99
122
  - `fs` 字节写 facet(当前仅整文件 UTF-8 文本写,≤4 MB,文本格式白名单);
100
123
  - 模式关联管理设置页(关联目前仅经模式菜单"设为默认/恢复默认"管理)。
101
124
 
125
+ 自动换行(0.10.0 引入,0.11.0 起为三层解析)的明确非目标(记录在案,去向已定):
126
+
127
+ - **4 MiB 编辑上限不随换行调整**:`MAX_EDIT_CHARS` / `MAX_CONTENT_CHARS` 是 textarea 预算,本版不动;与「大文件模式」一并解决;
128
+ - **无渐进分块测量(A2)**:本版只有挂载时的一轮有界初始化分块,不维护"部分精确"的常驻状态;与「大文件模式」一并解决(届时只换测量模块内部,查询接口与组件触点不变);
129
+ - **按类型覆盖只支持 `*.<ext>` 形态**:换行覆盖按扩展名后缀匹配(单段 `*` + 点 + 1–16 位小写字母/数字),不支持任意 minimatch glob(如 `src/**`、`*.test.*`)与按工作区/目录的作用域;任意 glob 随未来的覆盖管理 UI 一起 additive;
130
+ - **无 `Alt+Z` 式临时开关**:不能只对当前页签临时切换换行且不持久化;等真实需求出现再 additive。
131
+
102
132
  另有:只能编辑会话工作区内的文本文件;编辑器以独立 tab 打开,不替换当前预览 tab;键位录制会拒绝浏览器生命周期保留组合(Ctrl/⌘+W/T/N/Q、Ctrl+Tab 等)并给出提示——页面层无法可靠拦截这类浏览器默认行为。
103
133
 
104
134
  ## 契约变更记录