@coda-console/resource-manager 0.6.0 → 0.7.1

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
@@ -3,13 +3,16 @@
3
3
  Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,读文本和图片,把路径交给对话。只读。
4
4
 
5
5
  - **Mac**:在会话侧栏里,和对话并排。
6
- - **iPhone**:在会话右上角菜单里打开,点文件推入一层。iPad 和 iPhone Duo 用同一套界面,没有单独适配。
6
+ - **iPhone**:在会话右上角菜单里打开,点文件在资源页里切到预览,系统返回(左上「‹」、左边缘侧滑)回到打开它的那一层。iPad 和 iPhone Duo 用同一套界面,没有单独适配。
7
7
 
8
8
  ## 功能
9
9
 
10
10
  - 两种视图:**列表**(目录树,按需展开,超大目录分页显示)和**图标**(一次看一层,每个条目是类型图标加名字,名字最多两行,`package.json` 这样的名字优先在扩展名前折行)。在「更多」菜单(Mac)或「⋯」菜单(iPhone)的「显示」›「视图」里切换,全局一份,两种视图各自保留滚动位置。
11
- - 图标视图里**单击文件夹进入这一层**,单击文件打开(Mac 在侧栏里切到文件,iPhone 推入文件页);回上一层:iPhone 用系统的返回,Mac 点头部最左边的返回键。**没有预览面板**:只有一个侧栏,不会单击选中再在旁边预览,也没有面包屑。
11
+ - **Mac 照 Finder**:单击只选中,**双击**打开——文件在侧栏里切到预览,文件夹在列表里展开或收起、在图标视图里进入;单击展开箭头只展开,选中不变;单击空白取消选中;右键菜单第一项是「打开」(文件夹在列表里写「展开」「收起」),不能打开的条目没有。**iPhone** 轻点就打开(文件夹展开或进入,文件在页内切到预览,不另开页面)。
12
+ - 图标视图回上一层:iPhone 用系统的返回,Mac 点头部最左边的返回键或按 ⌘↑,退回的那一层里选中刚才进去的文件夹。**没有预览面板**:只有一个侧栏,也没有面包屑。
13
+ - **Mac 的键盘**:点一下目录树或图标视图让它拿到焦点(Tab 也能进来),↑ ↓ 移动选中(图标视图按行列走),列表里 → 展开、← 收起或选中所在的文件夹,图标视图里 ← → 选左右的条目;⌘↓ 同双击(打开、展开、进入);⌘↑ 在图标视图里回上一层,在预览里返回目录树或图标视图。不做多选、按字母跳转,Return 和空格也没绑定。读屏的 `aria-activedescendant` 没做(见 `docs/backlog.md`)。
12
14
  - 文本预览(带行号,可跨行选中复制,最多读 1 MiB)和图片预览(PNG、JPEG、GIF、WebP、SVG,最多 8 MiB)。
15
+ - 代码按语言上色:三十多种常见语言,只按文件名和扩展名认,不猜内容,深浅各一套配色;认不出的显示纯文本。超过 128 KiB 的文件不上色,说明区注明「不高亮」。用的是近似的语法规则,不是语法检查,个别文件会认错(如 `.h` 一律按 C++,`.m` 一律按 Objective-C),不保证完整支持。
13
16
  - Agent 一轮结束后,已展开的目录和正在看的文件自动更新。
14
17
  - 每行带修改日期和大小:Mac 在名字右边(按日期排序时显示日期,否则显示大小,侧栏很窄时隐藏),iPhone 在名字下面一行。右键或长按的菜单里有大小和完整修改时间。文件夹不显示大小(列表和菜单都没有),只有修改日期。
15
18
  - 可以按名称、种类、日期、大小排序,在「更多」菜单(Mac)或「⋯」菜单(iPhone)的「显示」›「排序」里选,当前项有对勾。两种视图用同一个排序。每种排序的方向固定:名称、种类升序,日期、大小降序(最新、最大在前),没有升降序切换。超过 2 万条的目录,日期和大小排序不可用,退回按名称并提示。排序全局一份,换了排序滚动位置回到顶部,选当前项什么都不做。
@@ -19,7 +22,7 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
19
22
  - 属性页:行菜单里选「属性」,在当前页里打开一层,用系统的返回退出。显示种类、大小、链接到、位置、完整路径、修改和创建时间、权限;文件夹的大小在打开后统计,不跟随链接,最多 20 万项或 5 秒,超出时显示下限(如「超过 3.2 GiB(已统计 20 万项)」),一轮结束后已有的结果标「上次统计」,可以重新统计。
20
23
  - **写入输入框用的是 Coda 没有公开的接口**,以后可能失效或改变;失效时「添加到聊天」会改为复制路径或文字。**已知风险**:输入框里的附件还在上传时添加,上传完成后,这段时间里打的字和那个附件可能消失;刚打完字的一瞬间添加,也可能丢掉这几个字。
21
24
  - Mac:把文件拖到输入框也行;预览可以开到独立窗口;工具栏只有一个「更多」按钮,按下弹出菜单:刷新、显示隐藏文件、「显示」›。鼠标移到「显示」或点它,在菜单左边弹出二级菜单(视图和排序);侧栏太窄放不下时,在菜单里切到下一层,顶上一行「返回」。侧栏预览头部最左边的「返回」回到目录树或图标视图。
22
- - iPhone:长按出同样的菜单;目录树页(或图标视图)右上角「⋯」里有刷新、显示隐藏文件和「显示」,点「显示」在菜单里切到下一层(视图和排序),顶上一行「返回」;文件页底部工具条有刷新和「复制路径」。
25
+ - iPhone:长按出同样的菜单;目录树页(或图标视图)右上角「⋯」里有刷新、显示隐藏文件和「显示」,点「显示」在菜单里切到下一层(视图和排序),顶上一行「返回」;预览时只有一行标题(预览头部),「⋯」在头部右边,里面只有刷新和「复制路径」。
23
26
  - 默认隐藏 `.git`、`.DS_Store`,Mac 在工具栏的「更多」菜单里、iPhone 在目录树页右上角的「⋯」里可切换显示全部。
24
27
 
25
28
  只能读这个会话的工作目录。指向工作目录之外的符号链接只显示,不能打开。
@@ -34,7 +37,7 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
34
37
 
35
38
  ## 开发
36
39
 
37
- 不需要安装依赖,也没有构建步骤。Node 由 Coda 提供(`$CODA_NODE`)。
40
+ 不需要安装依赖,也没有构建步骤;第三方代码只有 `view/vendor/highlight/` 下原样复制的 highlight.js(升级方法见三期设计第 15.2 节)。Node 由 Coda 提供(`$CODA_NODE`)。
38
41
 
39
42
  ```sh
40
43
  # 测试,也可以用 npm test。Node 24 上不能写成 node --test test/
@@ -43,7 +46,7 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
43
46
  # 不进 Coda,用假的 window.coda 在浏览器里看真实页面
44
47
  "$CODA_NODE" test/harness/server.mjs <会话A的目录> [会话B的目录] [端口]
45
48
 
46
- # 真实布局的断言和截图:无头 Chrome 打开 Mac 侧栏、iPhone 竖屏和横屏的目录树、图标视图与文件页(浅色、深色),
49
+ # 真实布局的断言和截图:无头 Chrome 打开 Mac 侧栏、iPhone 竖屏和横屏的目录树、图标视图与资源页里的预览(浅色、深色),
47
50
  # 量行高、工具条、菜单和二级菜单的位置和尺寸,图标视图的单元格和滚动。自己起服务和临时目录,用完删掉;截图在系统临时目录里,路径在最后打印。
48
51
  # 失败时退出码非 0。Chrome 不在默认位置时把路径作参数传入
49
52
  "$CODA_NODE" test/harness/layout.mjs [Chrome 的路径]
@@ -77,4 +80,6 @@ npx --yes github:coda-console/coda-plugins#<提交> . --manifest
77
80
 
78
81
  ## 许可
79
82
 
80
- MIT
83
+ MIT。
84
+
85
+ 第三方:`view/vendor/highlight/` 里是 [highlight.js](https://highlightjs.org/) 11.12.0 的浏览器构建,BSD-3-Clause 许可,版权声明和许可全文在同目录的 `LICENSE`,文件原样复制,没有修改。
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "name": "@coda-console/resource-manager",
4
4
  "displayName": "资源管理器",
5
5
  "description": "会话旁的只读文件浏览器:浏览会话工作目录,预览文本和图片,把路径交给对话。",
6
- "version": "0.6.0",
6
+ "version": "0.7.1",
7
7
  "categories": ["工作流程"],
8
8
  "license": "MIT",
9
9
  "repository": {
package/view/app.mjs CHANGED
@@ -12,18 +12,19 @@ import { showNotice } from './notice.mjs';
12
12
  import { mountPreview } from './preview.mjs';
13
13
  import { EntryKind, RootState, SortKey, Type } from './protocol.mjs';
14
14
  import { createRestore, createTrail } from './restore.mjs';
15
+ import { browseAction, previewAction } from './keys.mjs';
15
16
  import { mountTree, rootName } from './tree.mjs';
16
17
 
17
18
  const coda = window.coda;
18
19
  const $ = id => document.getElementById(id);
19
20
  const quiet = fn => { try { return fn(); } catch { return undefined; } };
20
21
  const hasToolbar = typeof coda.toolbar === 'function' && coda.platform === 'mac';
21
- // iPhone 上打开文件推入新视图,树页不进预览模式;selected 只用来高亮,从保存的状态恢复出来也一样。
22
+ // 两端都在资源页里打开文件、切到预览(第 16 节):iPhone 轻点打开、系统返回关掉,Mac 照 Finder 单击选中、双击打开,键盘接在目录树和图标视图的滚动容器上。
22
23
  const isIOS = coda.platform === 'ios';
23
24
 
24
25
  let persisted = parseState(quiet(() => coda.getState()));
25
- // 恢复出来的预览滚动位置,等内容到了再用一次。目录树和图标视图的在 restore 里。
26
- let pending = { preview: null };
26
+ // 恢复出来的预览滚动位置,等内容到了再用一次;path 是它属于的文件,opened 不是它了就作废。目录树和图标视图的在 restore 里。
27
+ let pending = { preview: null, path: null };
27
28
 
28
29
  const conn = connect(coda, { handlers: { session: onSession, root: onRoot, changed: onChanged }, onStatus: () => schedule() });
29
30
  const model = new Model({ link: conn.link, onChange: () => schedule(), onLost: () => hint.show('文件夹已不存在', { warn: false }) });
@@ -42,7 +43,8 @@ const tree = mountTree($('tree'), model, {
42
43
  more: path => model.loadMore(path),
43
44
  retry: path => model.retry(path),
44
45
  menu: (event, row) => pathMenu(event, row),
45
- }, { draggable: !isIOS, longPress: isIOS });
46
+ select: isIOS ? null : path => selectEntry(path),
47
+ }, { draggable: !isIOS, longPress: isIOS, keyboard: !isIOS });
46
48
  const grid = mountGrid($('grid'), model, {
47
49
  open: openFile,
48
50
  enter: path => enterDir(path),
@@ -50,13 +52,15 @@ const grid = mountGrid($('grid'), model, {
50
52
  retry: path => model.retry(path),
51
53
  menu: (event, cell) => pathMenu(event, cell),
52
54
  back: nativeBack ? null : () => leaveDir(),
53
- }, { draggable: !isIOS, longPress: isIOS });
55
+ select: isIOS ? null : path => selectEntry(path),
56
+ }, { draggable: !isIOS, longPress: isIOS, keyboard: !isIOS });
54
57
  const restore = createRestore(model, { tree, grid });
55
58
  const trail = createTrail();
56
59
  const preview = mountPreview($('preview'), {
57
60
  read: (path, offset) => conn.link.call('read', { path, offset }), copy: text => coda.copy(text),
58
- actions: isIOS ? [] : [{ label: '窗口', icon: 'window', run: openInView }], copyInHead: !isIOS,
59
- back: isIOS ? null : () => { backPressed = true; model.select(null); },
61
+ // iPhone 预览头部右边的 ⋯(刷新、复制路径):顶部工具条在预览时只有「返回」,只留头部一行标题
62
+ actions: isIOS ? [{ label: '更多', icon: 'ellipsis', run: (_, button) => toggleMore(button) }] : [{ label: '窗口', icon: 'window', run: openInView }], copyInHead: !isIOS,
63
+ back: isIOS ? null : closePreview,
60
64
  // 选中文字的右键菜单只有 Mac:iPhone 用系统的选区菜单。
61
65
  selectionMenu: isIOS ? null : (event, selection) => menu.open(event, { items: chat.selectionItems(selection) }),
62
66
  });
@@ -71,32 +75,22 @@ const info = mountInfo($('info'), {
71
75
  back: nativeBack ? null : () => { backPressed = true; closeInfo(); },
72
76
  });
73
77
 
74
- // ---- 在独立视图里打开:iPhone 点文件,Mac 预览头部的「窗口」 ----
78
+ // ---- 在独立视图里打开:Mac 预览头部的「窗口」 ----
75
79
  // 会话 ID 放进 args:被打开的视图 context.session 是 null。失败(含同步抛出)在原地提示。
76
- // iPhone 防连点:open 进行中、成功后推入动画的这一小段都忽略重复点击;失败立刻放开。
77
- // epoch 每换一次会话加一:旧会话的 open 结果回来时已经作废,不碰新会话的提示和防连点。
78
- let opening = false, unlockTimer = null, epoch = 0;
79
- const REOPEN_MS = 1000;
80
+ // epoch 每换一次会话加一:旧会话的 open 结果回来时已经作废,不碰新会话的提示。
81
+ let epoch = 0;
80
82
  function openInView(path) {
81
- if (isIOS) opening = true;
82
83
  const mine = epoch;
83
84
  return Promise.resolve().then(() => coda.open({ view: 'file', args: { session: model.session, path } }))
84
- .then(() => {
85
- if (mine !== epoch) return;
86
- hint.hide();
87
- if (isIOS) { clearTimeout(unlockTimer); unlockTimer = setTimeout(() => { opening = false; }, REOPEN_MS); }
88
- }, error => {
89
- if (mine !== epoch) return;
90
- opening = false;
91
- hint.show(`打不开文件:${error?.message ?? '未知原因'}`);
85
+ .then(() => { if (mine === epoch) hint.hide(); }, error => {
86
+ if (mine === epoch) hint.show(`打不开文件:${error?.message ?? '未知原因'}`);
92
87
  });
93
88
  }
89
+ // 两端都在页内打开:model.openFile 设 selected 和 opened,经 onChange 切到预览。iPhone 触屏没有键盘焦点,不交焦点;
90
+ // 快速两次轻点:第一次已切到预览,目录树 .off 不接指针事件,第二次落不到条目上。
94
91
  function openFile(path) {
95
- if (isIOS && opening) return; // 先于 select 和保存:被忽略的点击什么都不改
96
- model.select(path);
97
- if (!isIOS) return;
98
- saveNow(); // 视图随即卸载,这一刻的展开状态、条数和滚动位置先存下
99
- openInView(path);
92
+ openPressed = !isIOS; // 用户在 Mac 上打开的:render 把焦点交给预览面板
93
+ model.openFile(path);
100
94
  }
101
95
 
102
96
  // ---- 渲染:同一批变化合并成一次 ----
@@ -108,9 +102,23 @@ function schedule() {
108
102
  queueMicrotask(() => { queued = false; render(); });
109
103
  }
110
104
 
111
- // 用户点了预览头部的返回:render 据此决定焦点要不要交给目录树,别的模式变化不动焦点。
105
+ // 选中:页面里唯一的入口(单击、取消选中、键盘移动、回上一层)。只改 model.selected 和现有节点上的 .sel,不重画,也不经 onChange;保存自己排。
106
+ function selectEntry(path) {
107
+ if (!model.select(path)) return;
108
+ (model.view === View.ICONS ? grid : tree).select();
109
+ queueSave();
110
+ }
111
+ const browser = () => (model.view === View.ICONS ? grid : tree);
112
+
113
+ // 预览头部的返回和预览里的 ⌘↑ 是同一个动作:opened 清掉,selected 留着。
114
+ function closePreview() {
115
+ backPressed = true;
116
+ model.closeFile();
117
+ }
118
+ // 用户点了预览头部的返回:render 据此决定焦点要不要交给浏览区,别的模式变化不动焦点。
112
119
  let backPressed = false;
113
- const mode = () => (infoOpen ? 'info' : !model.ready ? 'notice' : model.selected !== null && !isIOS ? 'preview' : model.view === View.ICONS ? 'grid' : 'tree');
120
+ let openPressed = false; // 用户打开了文件:同返回对称,页面持有焦点时 render 把焦点交给预览面板
121
+ const mode = () => (infoOpen ? 'info' : !model.ready ? 'notice' : model.opened !== null ? 'preview' : model.view === View.ICONS ? 'grid' : 'tree');
114
122
 
115
123
  // 说明区只在内容变了才重画,免得重试按钮在点击中途被换掉。
116
124
  let noticeKey = null;
@@ -124,8 +132,8 @@ function paintNotice() {
124
132
 
125
133
  function render() {
126
134
  const current = mode();
127
- const refocus = backPressed && document.hasFocus();
128
- backPressed = false;
135
+ const refocus = backPressed && document.hasFocus(), handoff = openPressed && document.hasFocus();
136
+ backPressed = openPressed = false;
129
137
  for (const id of ['tree', 'grid', 'preview', 'notice', 'info']) {
130
138
  $(id).classList.toggle('off', current !== id);
131
139
  $(id).inert = current !== id;
@@ -135,13 +143,18 @@ function render() {
135
143
  (model.view === View.ICONS ? grid : tree).render(); // 只画正在用的视图,另一个留着它的内容和滚动位置
136
144
  landed();
137
145
  restore.settle();
138
- if (current === 'preview' && preview.path !== model.selected) {
139
- preview.open(model.selected, pending.preview);
140
- pending.preview = null;
146
+ // 待恢复的位置只属于它那个文件:opened 清了或换成别的文件,位置作废。
147
+ if (pending.preview !== null && pending.path !== model.opened) pending.preview = null;
148
+ if (current === 'preview' && preview.path !== model.opened) {
149
+ // 位置要等内容到了、真的设上才清:之前离开页面或换会话,saveNow 还存它。作废的读取不清,由接替它的读取用上。
150
+ const scroll = pending.preview;
151
+ preview.open(model.opened, scroll).then(used => { if (used && scroll !== null && pending.preview === scroll) pending.preview = null; });
141
152
  } else if ((browsing || current === 'notice') && preview.path !== null) preview.close(); // 属性页和预览一样只切可见性,不动别的面板的内容
142
153
  // 返回按钮随预览一起 inert,焦点会掉到页面外:用户刚点了返回、页面又持有焦点时交给目录树或网格。
143
154
  // 后台刷新、切会话、root 变化造成的切换不动焦点,免得抢走客户端输入框的焦点。
144
- if (refocus && browsing) { $(current).tabIndex = -1; $(current).focus(); }
155
+ if (refocus && browsing) browser().focus();
156
+ // 打开时浏览区变 inert,焦点本来就会掉:交给预览面板,⌘↑ 才收得到。
157
+ if (handoff && current === 'preview') $('preview').focus();
145
158
  syncToolbar();
146
159
  declareBack();
147
160
  }
@@ -156,9 +169,10 @@ const toolbarItems = () => infoOpen ? [] : hasToolbar
156
169
  { id: 'hidden', label: '显示隐藏文件', icon: 'eye', kind: 'toggle', on: model.showHidden },
157
170
  ];
158
171
  // iPhone 树页顶部:返回(仅横屏)、根目录名、⋯。刷新、显示隐藏文件和排序都在 ⋯ 的菜单里。
172
+ // 预览时和属性页一样只留返回(竖屏整条不显示):标题和 ⋯ 在预览头部,⋯ 里只有刷新和复制路径。
159
173
  // 属性页上只留返回:竖屏有原生导航栏,整条工具条不显示;横屏导航栏隐藏,页面自己给返回(显示与否都由 style.css 的横屏媒体查询决定)。
160
174
  const MORE = { id: 'more', label: '更多', kind: 'button', glyph: 'ellipsis', iconOnly: true, menu: true };
161
- const phoneItems = () => infoOpen ? [EXIT] : [EXIT, { kind: 'title', label: model.ready ? dirTitle() : '' }, MORE];
175
+ const phoneItems = () => infoOpen || mode() === 'preview' ? [EXIT] : [EXIT, { kind: 'title', label: model.ready ? dirTitle() : '' }, MORE];
162
176
  // 比较键就是要画的项:根目录名变了(换会话)工具条跟着重画。
163
177
  let lastItems = '';
164
178
  function syncToolbar() {
@@ -175,7 +189,10 @@ function syncToolbar() {
175
189
  // 原生按钮没有 DOM 元素可以当锚点:用一个固定在页面右上角的假锚点,同时也是「谁打开的菜单」的标记。
176
190
  const TOOLBAR = { getBoundingClientRect: () => ({ right: window.innerWidth, bottom: 0 }) };
177
191
  // 「更多」菜单的内容只写这一处,iPhone 的 ⋯ 和 Mac 的原生按钮共用:刷新、显示隐藏文件、「显示」›;「显示」里是视图和排序,当前项有对勾。
178
- const moreMenu = () => ({ items: [
192
+ const moreMenu = () => isIOS && mode() === 'preview' ? { items: [
193
+ { label: '刷新', run: () => act('refresh') },
194
+ { label: '复制路径', run: () => preview.copyPath() }, // 相对路径
195
+ ] } : ({ items: [
179
196
  { label: '刷新', run: () => act('refresh') },
180
197
  { label: '显示隐藏文件', checked: model.showHidden, run: () => act('hidden') },
181
198
  { label: '显示', submenu: { items: [
@@ -217,13 +234,17 @@ function changeView(view) {
217
234
  schedule();
218
235
  }
219
236
 
237
+ // 键盘激活没有 pointerdown,菜单外点击那条规则不管用:同一个按钮再次激活就关闭。
238
+ function toggleMore(button) {
239
+ if (!menu.hidden && menu.opener === button) menu.hide();
240
+ else menu.open(button, moreMenu());
241
+ }
242
+
220
243
  function act(id, button) {
221
244
  // 横屏时导航栏隐藏,原生返回看不到:这里的「返回」和原生返回走同一个退层逻辑,在根层才关视图。
222
245
  if (id === EXIT.id) { if (goBack(1)) backPressed = true; else quiet(() => coda.close()); }
223
246
  else if (id === 'more') {
224
- // 键盘激活没有 pointerdown,菜单外点击那条规则不管用:同一个按钮再次激活就关闭。
225
- if (!menu.hidden && menu.opener === button) menu.hide();
226
- else menu.open(button, moreMenu());
247
+ toggleMore(button);
227
248
  }
228
249
  else if (id === 'hidden') {
229
250
  model.setShowHidden(!model.showHidden);
@@ -273,7 +294,11 @@ preview.onScroll(menu.hide);
273
294
  // 不能打开的条目(指向外面或失效的链接、other)没有「添加到聊天」,和不能拖动一致;它们仍有复制路径和属性。
274
295
  function pathMenu(event, row) {
275
296
  const dead = row.kind === EntryKind.LINK || row.kind === EntryKind.OTHER;
297
+ // Mac 的第一项和双击是同一个动作(右键不改选中);文件夹在列表里写展开或收起,别的写打开。iPhone 轻点就是打开,菜单不变。
298
+ const folder = row.kind === EntryKind.DIR, listed = model.view !== View.ICONS;
299
+ const open = isIOS || dead ? [] : [{ label: folder && listed ? (row.open ? '收起' : '展开') : '打开', run: () => browser().activate(row) }, { separator: true }];
276
300
  menu.open(event, { title: row.path, detail: dead ? undefined : infoText(row) || undefined, items: [
301
+ ...open,
277
302
  ...(dead ? [] : [{ label: '添加到聊天', run: () => chat.add(row.path) }]),
278
303
  { label: '复制相对路径', run: () => coda.copy(row.path) },
279
304
  { label: '复制绝对路径', run: () => coda.copy(`${model.root.path}/${row.path}`) },
@@ -284,12 +309,35 @@ function pathMenu(event, row) {
284
309
  $('tree').addEventListener('scroll', menu.hide, { passive: true });
285
310
  grid.onScroll(menu.hide);
286
311
 
312
+ // ---- 键盘(Mac)----
313
+ // 两个作用域各管各的,匹配的键同步 preventDefault,不匹配的不拦;菜单开着不处理,两处都不主动抢焦点。
314
+ // 浏览区:按了键就算用户自己动了,作废这个视图还在等的滚动恢复,即使这次不用滚动;⌘↑ 只有图标视图有(回上一层,同头部的返回),根目录什么都不做。
315
+ function browseKey(event) {
316
+ if (isIOS || !menu.hidden) return;
317
+ const action = browseAction(event), icons = model.view === View.ICONS;
318
+ if (!action || (action === 'parent' && !icons)) return;
319
+ event.preventDefault();
320
+ restore.drop(icons ? 'grid' : 'tree');
321
+ if (action === 'open') browser().openSelected();
322
+ else if (action === 'parent') leaveDir();
323
+ else browser().key(action);
324
+ }
325
+ tree.onKey(browseKey);
326
+ grid.onKey(browseKey);
327
+ // 侧栏预览:只有 ⌘↑,返回。焦点要在面板里才收得到(点正文、打开时交接)。
328
+ $('preview').addEventListener('keydown', event => {
329
+ if (isIOS || infoOpen || !menu.hidden || !previewAction(event)) return;
330
+ event.preventDefault();
331
+ closePreview();
332
+ });
333
+
287
334
  // ---- 图标视图的进入和返回 ----
288
335
  // 进入子目录滚到顶部,先记下上层的位置;回上一层恢复进去之前的位置(记录在内存里,页面卸载后没有,回到顶部)。
289
336
  // shownCwd:页面已经处理过的 cwd;它被模型自己换掉(目录没了退到上一层、根目录变了回到根目录)时,在 landed 里补上滚动。
290
337
  let shownCwd = '';
291
338
  function enterDir(path) {
292
339
  trail.remember(model.cwd, grid.scroll());
340
+ selectEntry(null); // 进入新的一层:选中清空
293
341
  model.enter(path);
294
342
  shownCwd = model.cwd;
295
343
  restore.drop('grid');
@@ -299,8 +347,11 @@ function enterDir(path) {
299
347
  // 退 levels 层(到根为止);已经在根目录返回 false。
300
348
  function leaveDir(levels = 1) {
301
349
  if (model.cwd === '') return false;
350
+ const from = model.cwd.split('/');
302
351
  model.leave(levels);
303
352
  land(trail.take(model.cwd) ?? 0);
353
+ // 选中来时经过的那个文件夹(退到的那一层的直接子项)。目录被删、模型自己退回上层走 landed,不改选中。
354
+ selectEntry(from.slice(0, model.cwd === '' ? 1 : model.cwd.split('/').length + 1).join('/'));
304
355
  declareBack();
305
356
  return true;
306
357
  }
@@ -315,13 +366,16 @@ function landed() {
315
366
  }
316
367
 
317
368
  // ---- 上一层:iPhone 用原生返回,路径只在这里声明 ----
318
- // 路径是上层的标题,由远到近,不含当前页:图标视图在 a/b 是 [根目录名, 'a'];列表视图没有。属性页多一层当前页:列表视图是 '资源管理器',图标视图是当前目录名。
369
+ // 路径是上层的标题,由远到近,不含当前页:图标视图在 a/b 是 [根目录名, 'a'];列表视图没有。属性页、预览各多一层当前页(要回到的那一页):列表视图是 '资源管理器',图标视图是当前目录名。
370
+ // 预览开着是 opened 不为空、且根目录就绪;没就绪时页面是说明区,路径为空。
319
371
  // 标题是当前目录名:根目录是根目录名。
320
372
  const dirTitle = () => (model.cwd === '' || model.view !== View.ICONS ? rootName(model.root.path) : model.cwd.slice(model.cwd.lastIndexOf('/') + 1));
373
+ const previewOpen = () => model.ready && model.opened !== null;
321
374
  function backPath() {
322
375
  const icons = model.view === View.ICONS && model.ready;
323
376
  const upper = icons && model.cwd !== '' ? [rootName(model.root.path), ...model.cwd.split('/').slice(0, -1)] : [];
324
- return infoOpen ? [...upper, icons ? dirTitle() : '资源管理器'] : upper;
377
+ const here = icons ? dirTitle() : '资源管理器';
378
+ return [...upper, ...(infoOpen ? [here] : []), ...(previewOpen() ? [here] : [])];
325
379
  }
326
380
  let declared = [];
327
381
  // 路径没变不重复声明;force:客户端已经退了一层,路径没变也要重新告诉它现在在哪。
@@ -332,9 +386,12 @@ function declareBack(force = false) {
332
386
  declared = path;
333
387
  quiet(() => coda.back(path));
334
388
  }
335
- // 退 steps 层:先关属性页,再退图标视图的目录;返回是不是真的退了。横屏的返回和原生返回共用。
389
+ // 退 steps 层:先关预览,再关属性页,再退图标视图的目录;返回是不是真的退了。横屏的返回和原生返回共用。
390
+ // 没就绪时页面是说明区,看不见预览和目录层:不消耗它们(保存的 opened、cwd 不变),横屏的返回直接关视图。
336
391
  function goBack(steps) {
392
+ if (!model.ready) return false;
337
393
  let used = 0;
394
+ if (previewOpen() && steps > used) { model.closeFile(); used++; } // 走和 Mac 一样的 closeFile:opened 清,selected 留着
338
395
  if (infoOpen && steps > used) { closeInfo(); used++; }
339
396
  const levels = Math.min(steps - used, model.view === View.ICONS && model.cwd !== '' ? model.cwd.split('/').length : 0);
340
397
  if (levels > 0) { leaveDir(levels); used += levels; }
@@ -368,11 +425,9 @@ function onSession(data) {
368
425
  tree.reset();
369
426
  grid.reset();
370
427
  epoch++;
371
- opening = false;
372
- clearTimeout(unlockTimer);
373
428
  hint.hide();
374
429
  const saved = persisted.sessions[data.session] ?? null;
375
- pending = { preview: saved ? { top: saved.scroll.top, left: saved.scroll.left } : null };
430
+ pending = saved?.opened ? { preview: { top: saved.scroll.top, left: saved.scroll.left }, path: saved.opened } : { preview: null, path: null };
376
431
  model.receive(data, saved);
377
432
  trail.clear();
378
433
  restore.clear();
@@ -389,9 +444,9 @@ function onRoot(data) {
389
444
  if (data.state !== RootState.READY || before?.path !== data.path) closeInfo(); // 属性页看的是旧根目录下的路径
390
445
  const scope = model.scope;
391
446
  const done = model.receive(data);
392
- if (model.scope !== scope) invalidateScroll(); // 换了根目录(同根重建不算):旧根目录的位置和记录不能给新的用
447
+ if (model.scope !== scope) { invalidateScroll(); pending.preview = null; } // 换了根目录(同根重建不算):旧根目录的位置和记录不能给新的用,待恢复的预览位置也是
393
448
  if (done && data.state === RootState.READY) {
394
- if (before?.path !== data.path) preview.reload(); else preview.refresh();
449
+ if (before?.path !== data.path) { if (model.opened !== null) preview.reload(); } else preview.refresh(); // 换了根目录,opened 已清空:旧预览随即关掉,不再读
395
450
  }
396
451
  }
397
452
 
package/view/file-app.mjs CHANGED
@@ -1,7 +1,8 @@
1
1
  // 文件视图的页面入口:读一个文件。会话和路径来自 coda.args(启动值),之后的变化走 context 事件;
2
2
  // 连接在 connection.mjs,预览在 preview.mjs,这里不创建目录树。设计见 docs/design/phase-2.md 第 7 节。
3
3
  // Mac 的独立窗口里选中文字右键可以添加到聊天(第 13.7 节);iPhone 不接,用系统的选区菜单。
4
- import { EXIT, paintBar } from './bar.mjs';
4
+ // iPhone 点文件在资源页里预览(第 16 节),不再进这个视图;别的入口仍可能在 iPhone 上打开它:没有工具条,靠系统返回离开。
5
+ import { paintBar } from './bar.mjs';
5
6
  import { createChat } from './chat.mjs';
6
7
  import { connect } from './connection.mjs';
7
8
  import { mountHint } from './hint.mjs';
@@ -15,7 +16,7 @@ const coda = window.coda;
15
16
  const $ = id => document.getElementById(id);
16
17
  const quiet = fn => { try { return fn(); } catch { return undefined; } };
17
18
  const hasToolbar = typeof coda.toolbar === 'function' && coda.platform === 'mac';
18
- const isIOS = coda.platform === 'ios'; // iPhone:复制路径在底部工具条,不在预览头部
19
+ const isIOS = coda.platform === 'ios';
19
20
 
20
21
  // 参数里的会话和路径,形状不对按没有处理。
21
22
  const argsOf = args => ({
@@ -37,7 +38,7 @@ const hint = mountHint($('hint'));
37
38
  const menu = mountMenu($('menu'));
38
39
  const chat = createChat({ link: conn.link, copy: text => coda.copy(text), hint });
39
40
  const preview = mountPreview($('preview'), {
40
- read: (path, offset) => conn.link.call('read', { path, offset }), copy: text => coda.copy(text), copyInHead: !isIOS,
41
+ read: (path, offset) => conn.link.call('read', { path, offset }), copy: text => coda.copy(text),
41
42
  selectionMenu: isIOS ? null : (event, selection) => menu.open(event, { items: chat.selectionItems(selection) }),
42
43
  });
43
44
 
@@ -70,7 +71,8 @@ function render() {
70
71
  function openPreview() {
71
72
  const { path } = want, scroll = restore;
72
73
  // 没有要恢复的位置就明确从头开始,不靠清空正文后滚动条自己归零。
73
- preview.open(path, scroll ?? { top: 0, left: 0 }).then(() => { if (preview.path === path && restore === scroll) restore = null; });
74
+ // 位置真正用上才清;读取被刷新、重载作废时,预览自己让接替的那次读取接着用。
75
+ preview.open(path, scroll ?? { top: 0, left: 0 }).then(used => { if (used && preview.path === path && restore === scroll) restore = null; });
74
76
  }
75
77
 
76
78
  // 预览收起前记下滚动位置,恢复后接着用;内容还没到时 restore 还没用掉,不覆盖。
@@ -125,18 +127,13 @@ quiet(() => coda.on('context', ({ args }) => {
125
127
  schedule();
126
128
  }));
127
129
 
128
- // ---- 工具条:Mac 用 coda.toolbar;iPhone 在底部放返回(仅横屏)、刷新、复制路径;其他(harness)退成页内一条 ----
130
+ // ---- 工具条:Mac 用 coda.toolbar;iPhone 没有;其他(harness)退成页内一条 ----
129
131
  const refresh = () => { conn.refresh(); preview.refresh(); };
130
- // 说明区下预览是关着的,复制的是启动值里的路径:模块不可用时也能把路径交给对话。
131
- const copyPath = () => (preview.path !== null ? preview.copyPath() : want.path !== null && coda.copy(want.path));
132
132
  const items = [{ id: 'refresh', label: '刷新', icon: 'arrow.clockwise', kind: 'button' }];
133
133
  if (hasToolbar) {
134
134
  quiet(() => coda.toolbar(items));
135
135
  quiet(() => coda.on('toolbar', ({ id }) => { if (id === 'refresh') refresh(); }));
136
- } else {
137
- const shown = isIOS ? [EXIT, { ...items[0], glyph: 'refresh' }, { id: 'copy', label: '复制路径', kind: 'button', glyph: 'copy' }] : items;
138
- paintBar($('bar'), shown, id => (id === EXIT.id ? quiet(() => coda.close()) : id === 'copy' ? copyPath() : refresh()));
139
- }
136
+ } else if (!isIOS) paintBar($('bar'), items, refresh);
140
137
 
141
138
  // ---- 阅读位置:setState 按视图和 args 隔离,每个文件自然分开 ----
142
139
  let saveTimer = null;
package/view/file.html CHANGED
@@ -7,11 +7,11 @@
7
7
  <link rel="stylesheet" href="style.css">
8
8
  </head>
9
9
  <body>
10
+ <div id="bar" class="bar" hidden></div>
10
11
  <main id="stage">
11
12
  <div id="preview" class="pane preview"></div>
12
13
  <div id="notice" class="pane empty secondary"></div>
13
14
  </main>
14
- <div id="bar" class="bar bottom" hidden></div>
15
15
  <div id="menu" class="menu" role="menu" hidden></div>
16
16
  <div id="hint" class="hint" role="status" hidden></div>
17
17
  <script type="module" src="file-app.mjs"></script>
package/view/gestures.mjs CHANGED
@@ -5,10 +5,12 @@ export const HOLD_SLOP = 10;
5
5
 
6
6
  // el:接事件的元素;scroller:滚动的元素(滚动事件不冒泡),缺省同 el。选项:
7
7
  // hit(event) → 点到的那一项或 undefined;pressable(item):能不能弹菜单、拖动、长按(目录树的说明行、「再显示」不能);
8
- // activate(item):点击;menu(event, item):右键,长按到点时收到 { clientX, clientY };dragText(item):拖动时带的文字(元素是否可拖由调用方设 draggable);
8
+ // activate(item):点击(iPhone);Mac 给了 select 就按 Finder 的规则:单击条目只 select(item),单击空白 select(null),双击条目才 activate(item);
9
+ // 说明行、「再显示」这类不能选的项单击就 activate,direct(event, item) 为真的点击(展开箭头)也直接 activate、不选中,双击它不再重复激活。
10
+ // 双击靠浏览器的 dblclick,要求派发时目标节点还在容器里,所以 select 不能重画。menu(event, item):右键,长按到点时收到 { clientX, clientY };dragText(item):拖动时带的文字(元素是否可拖由调用方设 draggable);
9
11
  // longPress:触屏上按住一项打开 menu,不设 touch-action,滚动照旧,滚动接管时收到 pointercancel 作废。
10
12
  // 返回 { reset, dispose }:reset 在切会话时调用,长按的等待和吞点击的标记都属于上一个会话;dispose 摘掉全部监听。
11
- export function mountGestures(el, { hit, pressable, activate, menu, dragText, longPress = false, scroller = el }) {
13
+ export function mountGestures(el, { hit, pressable, activate, select, direct = () => false, menu, dragText, longPress = false, scroller = el }) {
12
14
  const listeners = [];
13
15
  const on = (target, type, fn, options) => { target.addEventListener(type, fn, options); listeners.push([target, type, fn]); };
14
16
 
@@ -39,7 +41,14 @@ export function mountGestures(el, { hit, pressable, activate, menu, dragText, lo
39
41
  on(el, 'click', event => {
40
42
  if (swallow) { swallow = false; return; }
41
43
  const item = hit(event);
42
- if (item) activate(item);
44
+ if (!select) { if (item) activate(item); return; }
45
+ if (!item) select(null);
46
+ else if (!pressable(item) || direct(event, item)) activate(item);
47
+ else select(item);
48
+ });
49
+ if (select) on(el, 'dblclick', event => {
50
+ const item = hit(event);
51
+ if (item && pressable(item) && !direct(event, item)) activate(item);
43
52
  });
44
53
  on(el, 'contextmenu', event => {
45
54
  const item = hit(event);
package/view/grid.mjs CHANGED
@@ -94,12 +94,40 @@ export function windowOf(layout, first, last) {
94
94
  return { from, to: Math.min(tail.from + tail.count, tail.note ? tail.from + 1 : firstOfRow(layout, last - 1) + layout.cols) };
95
95
  }
96
96
 
97
- // handlers: { open(path), enter(path), more(path), retry(path), menu(event, cell), back? }
97
+ // 键盘在图标视图里的一步(纯逻辑):action 是 up、down、left、right。返回 { select: 序号 } 或 null。
98
+ // 上下走同一列:跳过说明项独占的行,目标行不满、没有这一列时选那一行的最后一个;左右在条目之间走(行尾接下一行的第一个)。
99
+ // 选中的条目不在 cells 里按没有选中算:↓ 选第一个条目,↑ 选最后一个。
100
+ export function stepCells(cells, layout, selected, action) {
101
+ const at = selected === null ? -1 : cells.findIndex(cell => cell.type === 'entry' && cell.path === selected);
102
+ const first = cells.findIndex(cell => cell.type === 'entry');
103
+ if (first < 0) return null;
104
+ if (at < 0) {
105
+ if (action === 'down') return { select: first };
106
+ if (action === 'up') return { select: cells.map(cell => cell.type).lastIndexOf('entry') };
107
+ return null;
108
+ }
109
+ if (action === 'left' || action === 'right') {
110
+ const next = at + (action === 'right' ? 1 : -1);
111
+ return cells[next]?.type === 'entry' ? { select: next } : null;
112
+ }
113
+ const row = rowOfCell(layout, at), column = at - firstOfRow(layout, row), step = action === 'down' ? 1 : -1;
114
+ for (let r = row + step; r >= 0 && r < layout.rows; r += step) {
115
+ const span = spanAt(layout, r);
116
+ if (span.note) continue;
117
+ return { select: Math.min(firstOfRow(layout, r) + column, span.from + span.count - 1) };
118
+ }
119
+ return null;
120
+ }
121
+
122
+ // handlers: { open(path), enter(path), more(path), retry(path), menu(event, cell), back?, select?(path | null) }
123
+ // select 是 Mac 单击选中,不给就是 iPhone 的轻点打开。
98
124
  // back 给了就在头部最左边放「返回」(Mac,和没有原生返回的环境);不给就没有头部,iPhone 用原生返回,标题在工具条上。
99
125
  // draggable、longPress 同 mountTree。
100
- export function mountGrid(el, model, handlers, { draggable = true, longPress = false } = {}) {
126
+ // keyboard:滚动容器(.gbody)可以获得焦点,键盘才接得上(Mac)。
127
+ export function mountGrid(el, model, handlers, { draggable = true, longPress = false, keyboard = false } = {}) {
101
128
  const head = h('div', { class: 'ghead' }), body = h('div', { class: 'gbody' }), spacer = h('div', { class: 'gspacer' }), win = h('div', { class: 'gwin' });
102
129
  head.hidden = true;
130
+ if (keyboard) body.tabIndex = 0;
103
131
  spacer.append(win);
104
132
  body.append(spacer);
105
133
  el.replaceChildren(head, body);
@@ -175,20 +203,33 @@ export function mountGrid(el, model, handlers, { draggable = true, longPress = f
175
203
  paint();
176
204
  }
177
205
 
178
- const gestures = mountGestures(el, {
206
+ // 点击(iPhone)、双击、⌘↓ 和右键「打开」共用这一份。
207
+ const activate = cell => {
208
+ if (cell.type === 'more') return handlers.more(cell.path);
209
+ if (cell.type === 'status') return cell.retry ? handlers.retry(cell.path) : undefined;
210
+ if (cell.kind === EntryKind.DIR) handlers.enter(cell.path);
211
+ else if (cell.kind === EntryKind.FILE) handlers.open(cell.path);
212
+ };
213
+ // 事件挂在 body 上:头部的返回键点击不算「点空白」。
214
+ const gestures = mountGestures(body, {
179
215
  hit: event => cells[event.target.closest?.('.gi')?.dataset.i],
180
216
  pressable: cell => cell.type === 'entry',
181
- activate: cell => {
182
- if (cell.type === 'more') return handlers.more(cell.path);
183
- if (cell.type === 'status') return cell.retry ? handlers.retry(cell.path) : undefined;
184
- if (cell.kind === EntryKind.DIR) handlers.enter(cell.path);
185
- else if (cell.kind === EntryKind.FILE) handlers.open(cell.path);
186
- },
217
+ activate,
218
+ select: handlers.select && (cell => handlers.select(cell ? cell.path : null)),
187
219
  menu: (event, cell) => handlers.menu(event, cell),
188
220
  dragText: cell => cell.path,
189
221
  longPress,
190
222
  scroller: body,
191
223
  });
224
+ // 选中变了只在现有节点上切 .sel,不重建:双击的 dblclick 要落在还在容器里的节点上。
225
+ const mark = () => { for (const node of win.children) node.classList.toggle('sel', cells[node.dataset.i]?.type === 'entry' && cells[node.dataset.i].path === model.selected); };
226
+ // 滚到这个单元格能看见,只滚最少的距离。
227
+ const reveal = index => {
228
+ const top = (spacer.offsetTop || 0) + rowTop(layout, rowOfCell(layout, index), cellH, noteH);
229
+ if (top < body.scrollTop) body.scrollTop = top;
230
+ else if (top + cellH > body.scrollTop + body.clientHeight) body.scrollTop = top + cellH - body.clientHeight;
231
+ paint();
232
+ };
192
233
  body.addEventListener('scroll', paint, { passive: true });
193
234
  new ResizeObserver(relayout).observe(body);
194
235
 
@@ -206,6 +247,20 @@ export function mountGrid(el, model, handlers, { draggable = true, longPress = f
206
247
  scrollTo(top) { body.scrollTop = top; paint(); }, // 浏览器的滚动事件随后还会画一次;这里先画,位置才马上对
207
248
  onScroll(fn) { body.addEventListener('scroll', fn, { passive: true }); },
208
249
  get layout() { return layout; },
250
+ select: mark,
251
+ activate,
252
+ focus() { body.focus(); },
253
+ onKey(fn) { body.addEventListener('keydown', fn); },
254
+ key(action) {
255
+ const step = stepCells(cells, layout, model.selected, action);
256
+ if (!step) return;
257
+ handlers.select(cells[step.select].path);
258
+ reveal(step.select);
259
+ },
260
+ openSelected() {
261
+ const cell = model.selected === null ? undefined : cells.find(item => item.type === 'entry' && item.path === model.selected);
262
+ if (cell) activate(cell);
263
+ },
209
264
  // 切会话时调用:长按的等待和吞点击的标记都属于上一个会话。
210
265
  reset() { gestures.reset(); },
211
266
  dispose() { gestures.dispose(); },