@coda-console/resource-manager 0.5.0 → 0.7.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 +16 -9
- package/lib/paths.mjs +5 -11
- package/package.json +1 -1
- package/view/app.mjs +223 -59
- package/view/chat.mjs +7 -3
- package/view/gestures.mjs +71 -0
- package/view/grid.mjs +268 -0
- package/view/highlight.mjs +93 -0
- package/view/icons.mjs +2 -3
- package/view/index.html +3 -1
- package/view/keys.mjs +15 -0
- package/view/languages.mjs +49 -0
- package/view/lookup.mjs +8 -0
- package/view/menu.mjs +152 -27
- package/view/model.mjs +135 -16
- package/view/preview.mjs +11 -2
- package/view/protocol.mjs +14 -0
- package/view/restore.mjs +57 -0
- package/view/selection.mjs +1 -1
- package/view/style.css +77 -19
- package/view/tree.mjs +67 -48
- package/view/vendor/highlight/LICENSE +29 -0
- package/view/vendor/highlight/highlight.min.mjs +1260 -0
- package/view/vendor/highlight/languages/dart.min.mjs +27 -0
- package/view/vendor/highlight/languages/dockerfile.min.mjs +8 -0
- package/view/vendor/highlight/languages/scala.min.mjs +28 -0
package/README.md
CHANGED
|
@@ -7,18 +7,22 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
|
|
|
7
7
|
|
|
8
8
|
## 功能
|
|
9
9
|
|
|
10
|
-
-
|
|
10
|
+
- 两种视图:**列表**(目录树,按需展开,超大目录分页显示)和**图标**(一次看一层,每个条目是类型图标加名字,名字最多两行,`package.json` 这样的名字优先在扩展名前折行)。在「更多」菜单(Mac)或「⋯」菜单(iPhone)的「显示」›「视图」里切换,全局一份,两种视图各自保留滚动位置。
|
|
11
|
+
- **Mac 照 Finder**:单击只选中,**双击**打开——文件在侧栏里切到预览,文件夹在列表里展开或收起、在图标视图里进入;单击展开箭头只展开,选中不变;单击空白取消选中;右键菜单第一项是「打开」(文件夹在列表里写「展开」「收起」),不能打开的条目没有。**iPhone 不变**:轻点就打开(文件夹展开或进入,文件推入文件页)。
|
|
12
|
+
- 图标视图回上一层:iPhone 用系统的返回,Mac 点头部最左边的返回键或按 ⌘↑,退回的那一层里选中刚才进去的文件夹。**没有预览面板**:只有一个侧栏,也没有面包屑。
|
|
13
|
+
- **Mac 的键盘**:点一下目录树或图标视图让它拿到焦点(Tab 也能进来),↑ ↓ 移动选中(图标视图按行列走),列表里 → 展开、← 收起或选中所在的文件夹,图标视图里 ← → 选左右的条目;⌘↓ 同双击(打开、展开、进入);⌘↑ 在图标视图里回上一层,在预览里返回目录树或图标视图。不做多选、按字母跳转,Return 和空格也没绑定。读屏的 `aria-activedescendant` 没做(见 `docs/backlog.md`)。
|
|
11
14
|
- 文本预览(带行号,可跨行选中复制,最多读 1 MiB)和图片预览(PNG、JPEG、GIF、WebP、SVG,最多 8 MiB)。
|
|
15
|
+
- 代码按语言上色:三十多种常见语言,只按文件名和扩展名认,不猜内容,深浅各一套配色;认不出的显示纯文本。超过 128 KiB 的文件不上色,说明区注明「不高亮」。用的是近似的语法规则,不是语法检查,个别文件会认错(如 `.h` 一律按 C++,`.m` 一律按 Objective-C),不保证完整支持。
|
|
12
16
|
- Agent 一轮结束后,已展开的目录和正在看的文件自动更新。
|
|
13
17
|
- 每行带修改日期和大小:Mac 在名字右边(按日期排序时显示日期,否则显示大小,侧栏很窄时隐藏),iPhone 在名字下面一行。右键或长按的菜单里有大小和完整修改时间。文件夹不显示大小(列表和菜单都没有),只有修改日期。
|
|
14
|
-
- 可以按名称、种类、日期、大小排序,在「更多」菜单(Mac)或「⋯」菜单(iPhone
|
|
18
|
+
- 可以按名称、种类、日期、大小排序,在「更多」菜单(Mac)或「⋯」菜单(iPhone)的「显示」›「排序」里选,当前项有对勾。两种视图用同一个排序。每种排序的方向固定:名称、种类升序,日期、大小降序(最新、最大在前),没有升降序切换。超过 2 万条的目录,日期和大小排序不可用,退回按名称并提示。排序全局一份,换了排序滚动位置回到顶部,选当前项什么都不做。
|
|
15
19
|
- 切换会话时换成新会话的内容,切回来恢复展开状态和滚动位置。
|
|
16
|
-
- 右键(Mac)或长按(iPhone)一行:添加到聊天、复制相对路径、复制绝对路径、属性。「添加到聊天」把相对路径接在输入框已有文字后面;指向工作目录外或已失效的链接、不能打开的条目没有这一项。成功时底部提示「已添加到输入框」,约 2
|
|
20
|
+
- 右键(Mac)或长按(iPhone)一行:添加到聊天、复制相对路径、复制绝对路径、属性。「添加到聊天」把相对路径接在输入框已有文字后面;指向工作目录外或已失效的链接、不能打开的条目没有这一项。成功时底部提示「已添加到输入框」,约 2 秒消失;写不进去时改为复制,提示「没能写入输入框,已复制」;剪贴板也写不进去时提示「没能写入,也没能复制」。
|
|
17
21
|
- **选中文字右键(只有 Mac)**:在文件预览(侧栏和独立窗口)里选中文字后右键,有「添加到聊天(内容)」「添加到聊天(位置)」「复制」。位置是 `src/app.ts:12-18`,只选一行时是 `src/app.ts:12`,只精确到行。选中的内容太长放不进一条消息时直接复制,提示「选中内容太长,已复制」。iPhone 用系统自带的选区菜单,不加这一项。
|
|
18
22
|
- 属性页:行菜单里选「属性」,在当前页里打开一层,用系统的返回退出。显示种类、大小、链接到、位置、完整路径、修改和创建时间、权限;文件夹的大小在打开后统计,不跟随链接,最多 20 万项或 5 秒,超出时显示下限(如「超过 3.2 GiB(已统计 20 万项)」),一轮结束后已有的结果标「上次统计」,可以重新统计。
|
|
19
23
|
- **写入输入框用的是 Coda 没有公开的接口**,以后可能失效或改变;失效时「添加到聊天」会改为复制路径或文字。**已知风险**:输入框里的附件还在上传时添加,上传完成后,这段时间里打的字和那个附件可能消失;刚打完字的一瞬间添加,也可能丢掉这几个字。
|
|
20
|
-
- Mac
|
|
21
|
-
- iPhone
|
|
24
|
+
- Mac:把文件拖到输入框也行;预览可以开到独立窗口;工具栏只有一个「更多」按钮,按下弹出菜单:刷新、显示隐藏文件、「显示」›。鼠标移到「显示」或点它,在菜单左边弹出二级菜单(视图和排序);侧栏太窄放不下时,在菜单里切到下一层,顶上一行「返回」。侧栏预览头部最左边的「返回」回到目录树或图标视图。
|
|
25
|
+
- iPhone:长按出同样的菜单;目录树页(或图标视图)右上角「⋯」里有刷新、显示隐藏文件和「显示」,点「显示」在菜单里切到下一层(视图和排序),顶上一行「返回」;文件页底部工具条有刷新和「复制路径」。
|
|
22
26
|
- 默认隐藏 `.git`、`.DS_Store`,Mac 在工具栏的「更多」菜单里、iPhone 在目录树页右上角的「⋯」里可切换显示全部。
|
|
23
27
|
|
|
24
28
|
只能读这个会话的工作目录。指向工作目录之外的符号链接只显示,不能打开。
|
|
@@ -33,7 +37,7 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
|
|
|
33
37
|
|
|
34
38
|
## 开发
|
|
35
39
|
|
|
36
|
-
|
|
40
|
+
不需要安装依赖,也没有构建步骤;第三方代码只有 `view/vendor/highlight/` 下原样复制的 highlight.js(升级方法见三期设计第 15.2 节)。Node 由 Coda 提供(`$CODA_NODE`)。
|
|
37
41
|
|
|
38
42
|
```sh
|
|
39
43
|
# 测试,也可以用 npm test。Node 24 上不能写成 node --test test/
|
|
@@ -42,8 +46,8 @@ Coda 插件:会话旁的文件浏览器。浏览这个会话的工作目录,
|
|
|
42
46
|
# 不进 Coda,用假的 window.coda 在浏览器里看真实页面
|
|
43
47
|
"$CODA_NODE" test/harness/server.mjs <会话A的目录> [会话B的目录] [端口]
|
|
44
48
|
|
|
45
|
-
# 真实布局的断言和截图:无头 Chrome 打开 Mac 侧栏、iPhone
|
|
46
|
-
#
|
|
49
|
+
# 真实布局的断言和截图:无头 Chrome 打开 Mac 侧栏、iPhone 竖屏和横屏的目录树、图标视图与文件页(浅色、深色),
|
|
50
|
+
# 量行高、工具条、菜单和二级菜单的位置和尺寸,图标视图的单元格和滚动。自己起服务和临时目录,用完删掉;截图在系统临时目录里,路径在最后打印。
|
|
47
51
|
# 失败时退出码非 0。Chrome 不在默认位置时把路径作参数传入
|
|
48
52
|
"$CODA_NODE" test/harness/layout.mjs [Chrome 的路径]
|
|
49
53
|
|
|
@@ -59,6 +63,7 @@ npx --yes github:coda-console/coda-plugins#<提交> . --manifest
|
|
|
59
63
|
|
|
60
64
|
- [一期设计](docs/design/phase-1.md):消息协议、路径校验和页面规则。
|
|
61
65
|
- [二期设计](docs/design/phase-2.md):iPhone 适配和独立文件视图。
|
|
66
|
+
- [三期设计](docs/design/phase-3.md):文件信息和排序、右键操作和类型图标、图标视图。
|
|
62
67
|
- [可选需求清单](docs/backlog.md):之后可能做的需求。
|
|
63
68
|
- [评审准则](.coda/review.md)。
|
|
64
69
|
|
|
@@ -75,4 +80,6 @@ npx --yes github:coda-console/coda-plugins#<提交> . --manifest
|
|
|
75
80
|
|
|
76
81
|
## 许可
|
|
77
82
|
|
|
78
|
-
MIT
|
|
83
|
+
MIT。
|
|
84
|
+
|
|
85
|
+
第三方:`view/vendor/highlight/` 里是 [highlight.js](https://highlightjs.org/) 11.12.0 的浏览器构建,BSD-3-Clause 许可,版权声明和许可全文在同目录的 `LICENSE`,文件原样复制,没有修改。
|
package/lib/paths.mjs
CHANGED
|
@@ -1,21 +1,15 @@
|
|
|
1
1
|
// 路径校验:页面只传相对路径,读取只用这里返回的规范路径。
|
|
2
2
|
import { realpath } from 'node:fs/promises';
|
|
3
3
|
import { join, sep } from 'node:path';
|
|
4
|
-
import { ErrorCode, fail } from '../view/protocol.mjs';
|
|
5
|
-
|
|
6
|
-
const CONTROL = /[\u0000-\u001f\u007f]/;
|
|
7
|
-
const MAX_PATH = 4096;
|
|
4
|
+
import { ErrorCode, fail, hasControl, splitRelative } from '../view/protocol.mjs';
|
|
8
5
|
|
|
9
6
|
// 名字里能不能带进路径(含控制字符的名字只显示,不能打开)。
|
|
10
|
-
export const isSafeName = name => !
|
|
7
|
+
export const isSafeName = name => !hasControl(name);
|
|
11
8
|
|
|
12
|
-
// 相对路径 →
|
|
9
|
+
// 相对路径 → 片段。规则在 view/protocol.mjs 的 splitRelative,页面恢复 cwd 时用的是同一个。
|
|
13
10
|
export function parseRelative(path) {
|
|
14
|
-
|
|
15
|
-
if (
|
|
16
|
-
if (path.startsWith('/')) throw fail(ErrorCode.INVALID_PATH, '只接受相对路径');
|
|
17
|
-
const segments = path.split('/').filter(part => part !== '' && part !== '.');
|
|
18
|
-
if (segments.includes('..')) throw fail(ErrorCode.INVALID_PATH, '路径不能含 ..');
|
|
11
|
+
const { segments, problem } = splitRelative(path);
|
|
12
|
+
if (problem) throw fail(ErrorCode.INVALID_PATH, problem);
|
|
19
13
|
return segments;
|
|
20
14
|
}
|
|
21
15
|
|
package/package.json
CHANGED
package/view/app.mjs
CHANGED
|
@@ -1,52 +1,70 @@
|
|
|
1
|
-
//
|
|
1
|
+
// 资源管理器的页面入口:消息收发、状态保留、工具栏和「更多」菜单、图标视图的进入和返回。状态在 model.mjs,渲染在 tree.mjs、grid.mjs、preview.mjs 和 info.mjs,菜单和提示在 menu.mjs 和 hint.mjs,滚动位置的恢复在 restore.mjs。
|
|
2
2
|
import { EXIT, paintBar } from './bar.mjs';
|
|
3
3
|
import { createChat } from './chat.mjs';
|
|
4
4
|
import { connect } from './connection.mjs';
|
|
5
5
|
import { infoText, sortName } from './format.mjs';
|
|
6
|
+
import { mountGrid } from './grid.mjs';
|
|
6
7
|
import { mountHint } from './hint.mjs';
|
|
7
8
|
import { mountInfo } from './info.mjs';
|
|
8
9
|
import { mountMenu } from './menu.mjs';
|
|
9
|
-
import { Model, STATE_LIMIT, noticeText, parseState, putSession, trimState } from './model.mjs';
|
|
10
|
+
import { Model, STATE_LIMIT, View, noticeText, parseState, putSession, trimState } from './model.mjs';
|
|
10
11
|
import { showNotice } from './notice.mjs';
|
|
11
12
|
import { mountPreview } from './preview.mjs';
|
|
12
13
|
import { EntryKind, RootState, SortKey, Type } from './protocol.mjs';
|
|
14
|
+
import { createRestore, createTrail } from './restore.mjs';
|
|
15
|
+
import { browseAction, previewAction } from './keys.mjs';
|
|
13
16
|
import { mountTree, rootName } from './tree.mjs';
|
|
14
17
|
|
|
15
18
|
const coda = window.coda;
|
|
16
19
|
const $ = id => document.getElementById(id);
|
|
17
20
|
const quiet = fn => { try { return fn(); } catch { return undefined; } };
|
|
18
21
|
const hasToolbar = typeof coda.toolbar === 'function' && coda.platform === 'mac';
|
|
19
|
-
// iPhone 上打开文件推入新视图,树页不进预览模式;selected
|
|
22
|
+
// iPhone 上打开文件推入新视图,树页不进预览模式;opened 一直是 null,selected 只用来高亮。
|
|
23
|
+
// Mac 照 Finder:单击选中、双击打开,键盘接在目录树和图标视图的滚动容器上。
|
|
20
24
|
const isIOS = coda.platform === 'ios';
|
|
21
25
|
|
|
22
26
|
let persisted = parseState(quiet(() => coda.getState()));
|
|
23
|
-
//
|
|
24
|
-
let pending = {
|
|
27
|
+
// 恢复出来的预览滚动位置,等内容到了再用一次。目录树和图标视图的在 restore 里。
|
|
28
|
+
let pending = { preview: null };
|
|
25
29
|
|
|
26
30
|
const conn = connect(coda, { handlers: { session: onSession, root: onRoot, changed: onChanged }, onStatus: () => schedule() });
|
|
27
|
-
const model = new Model({ link: conn.link, onChange: () => schedule() });
|
|
31
|
+
const model = new Model({ link: conn.link, onChange: () => schedule(), onLost: () => hint.show('文件夹已不存在', { warn: false }) });
|
|
28
32
|
model.showHidden = persisted.hidden;
|
|
29
33
|
model.sort = persisted.sort;
|
|
34
|
+
model.view = persisted.view;
|
|
30
35
|
const hint = mountHint($('hint'));
|
|
31
|
-
const menu = mountMenu($('menu'));
|
|
36
|
+
const menu = mountMenu($('menu'), $('submenu'), { flyout: !isIOS }); // Mac 的二级菜单在左边弹出,iPhone 在菜单里切到下一层
|
|
32
37
|
const chat = createChat({ link: conn.link, copy: text => coda.copy(text), hint });
|
|
38
|
+
// 属性页和图标视图的上一层:iPhone 用原生返回(coda.back);Mac 的客户端会替声明了返回的页面画一个带小箭头的导航,
|
|
39
|
+
// 和侧栏标题重复,所以 Mac 和没有 coda.back 的环境一样,头部最左边自己放返回。
|
|
40
|
+
const nativeBack = isIOS && typeof coda.back === 'function';
|
|
33
41
|
const tree = mountTree($('tree'), model, {
|
|
34
42
|
open: openFile,
|
|
35
43
|
toggle: path => model.toggle(path),
|
|
36
44
|
more: path => model.loadMore(path),
|
|
37
45
|
retry: path => model.retry(path),
|
|
38
46
|
menu: (event, row) => pathMenu(event, row),
|
|
39
|
-
|
|
47
|
+
select: isIOS ? null : path => selectEntry(path),
|
|
48
|
+
}, { draggable: !isIOS, longPress: isIOS, keyboard: !isIOS });
|
|
49
|
+
const grid = mountGrid($('grid'), model, {
|
|
50
|
+
open: openFile,
|
|
51
|
+
enter: path => enterDir(path),
|
|
52
|
+
more: path => model.loadMore(path),
|
|
53
|
+
retry: path => model.retry(path),
|
|
54
|
+
menu: (event, cell) => pathMenu(event, cell),
|
|
55
|
+
back: nativeBack ? null : () => leaveDir(),
|
|
56
|
+
select: isIOS ? null : path => selectEntry(path),
|
|
57
|
+
}, { draggable: !isIOS, longPress: isIOS, keyboard: !isIOS });
|
|
58
|
+
const restore = createRestore(model, { tree, grid });
|
|
59
|
+
const trail = createTrail();
|
|
40
60
|
const preview = mountPreview($('preview'), {
|
|
41
61
|
read: (path, offset) => conn.link.call('read', { path, offset }), copy: text => coda.copy(text),
|
|
42
62
|
actions: isIOS ? [] : [{ label: '窗口', icon: 'window', run: openInView }], copyInHead: !isIOS,
|
|
43
|
-
back: isIOS ? null :
|
|
63
|
+
back: isIOS ? null : closePreview,
|
|
44
64
|
// 选中文字的右键菜单只有 Mac:iPhone 用系统的选区菜单。
|
|
45
65
|
selectionMenu: isIOS ? null : (event, selection) => menu.open(event, { items: chat.selectionItems(selection) }),
|
|
46
66
|
});
|
|
47
|
-
// 属性页:页内一层。
|
|
48
|
-
// 和侧栏标题重复,所以 Mac 和没有 coda.back 的环境一样,头部最左边自己放返回。
|
|
49
|
-
const nativeBack = isIOS && typeof coda.back === 'function';
|
|
67
|
+
// 属性页:页内一层。
|
|
50
68
|
let infoOpen = false;
|
|
51
69
|
let dataRound = 0; // 数据轮次:每收到一次 changed 加一,属性页用它判断文件夹的统计结果是不是上一轮的
|
|
52
70
|
const info = mountInfo($('info'), {
|
|
@@ -79,8 +97,11 @@ function openInView(path) {
|
|
|
79
97
|
}
|
|
80
98
|
function openFile(path) {
|
|
81
99
|
if (isIOS && opening) return; // 先于 select 和保存:被忽略的点击什么都不改
|
|
82
|
-
|
|
83
|
-
|
|
100
|
+
if (!isIOS) {
|
|
101
|
+
openPressed = true; // 用户打开的:render 把焦点交给预览面板
|
|
102
|
+
return model.openFile(path);
|
|
103
|
+
}
|
|
104
|
+
selectEntry(path);
|
|
84
105
|
saveNow(); // 视图随即卸载,这一刻的展开状态、条数和滚动位置先存下
|
|
85
106
|
openInView(path);
|
|
86
107
|
}
|
|
@@ -94,9 +115,23 @@ function schedule() {
|
|
|
94
115
|
queueMicrotask(() => { queued = false; render(); });
|
|
95
116
|
}
|
|
96
117
|
|
|
97
|
-
//
|
|
118
|
+
// 选中:页面里唯一的入口(单击、取消选中、键盘移动、回上一层)。只改 model.selected 和现有节点上的 .sel,不重画,也不经 onChange;保存自己排。
|
|
119
|
+
function selectEntry(path) {
|
|
120
|
+
if (!model.select(path)) return;
|
|
121
|
+
(model.view === View.ICONS ? grid : tree).select();
|
|
122
|
+
queueSave();
|
|
123
|
+
}
|
|
124
|
+
const browser = () => (model.view === View.ICONS ? grid : tree);
|
|
125
|
+
|
|
126
|
+
// 预览头部的返回和预览里的 ⌘↑ 是同一个动作:opened 清掉,selected 留着。
|
|
127
|
+
function closePreview() {
|
|
128
|
+
backPressed = true;
|
|
129
|
+
model.closeFile();
|
|
130
|
+
}
|
|
131
|
+
// 用户点了预览头部的返回:render 据此决定焦点要不要交给浏览区,别的模式变化不动焦点。
|
|
98
132
|
let backPressed = false;
|
|
99
|
-
|
|
133
|
+
let openPressed = false; // 用户打开了文件:同返回对称,页面持有焦点时 render 把焦点交给预览面板
|
|
134
|
+
const mode = () => (infoOpen ? 'info' : !model.ready ? 'notice' : model.opened !== null && !isIOS ? 'preview' : model.view === View.ICONS ? 'grid' : 'tree');
|
|
100
135
|
|
|
101
136
|
// 说明区只在内容变了才重画,免得重试按钮在点击中途被换掉。
|
|
102
137
|
let noticeKey = null;
|
|
@@ -110,22 +145,28 @@ function paintNotice() {
|
|
|
110
145
|
|
|
111
146
|
function render() {
|
|
112
147
|
const current = mode();
|
|
113
|
-
const refocus = backPressed && document.hasFocus();
|
|
114
|
-
backPressed = false;
|
|
115
|
-
for (const
|
|
116
|
-
$(id).classList.toggle('off', current !==
|
|
117
|
-
$(id).inert = current !==
|
|
148
|
+
const refocus = backPressed && document.hasFocus(), handoff = openPressed && document.hasFocus();
|
|
149
|
+
backPressed = openPressed = false;
|
|
150
|
+
for (const id of ['tree', 'grid', 'preview', 'notice', 'info']) {
|
|
151
|
+
$(id).classList.toggle('off', current !== id);
|
|
152
|
+
$(id).inert = current !== id;
|
|
118
153
|
}
|
|
119
154
|
if (current === 'notice') paintNotice();
|
|
120
|
-
tree
|
|
121
|
-
|
|
122
|
-
|
|
155
|
+
const browsing = current === 'tree' || current === 'grid';
|
|
156
|
+
(model.view === View.ICONS ? grid : tree).render(); // 只画正在用的视图,另一个留着它的内容和滚动位置
|
|
157
|
+
landed();
|
|
158
|
+
restore.settle();
|
|
159
|
+
if (current === 'preview' && preview.path !== model.opened) {
|
|
160
|
+
preview.open(model.opened, pending.preview);
|
|
123
161
|
pending.preview = null;
|
|
124
|
-
} else if ((
|
|
125
|
-
// 返回按钮随预览一起 inert
|
|
162
|
+
} else if ((browsing || current === 'notice') && preview.path !== null) preview.close(); // 属性页和预览一样只切可见性,不动别的面板的内容
|
|
163
|
+
// 返回按钮随预览一起 inert,焦点会掉到页面外:用户刚点了返回、页面又持有焦点时交给目录树或网格。
|
|
126
164
|
// 后台刷新、切会话、root 变化造成的切换不动焦点,免得抢走客户端输入框的焦点。
|
|
127
|
-
if (refocus &&
|
|
165
|
+
if (refocus && browsing) browser().focus();
|
|
166
|
+
// 打开时浏览区变 inert,焦点本来就会掉:交给预览面板,⌘↑ 才收得到。
|
|
167
|
+
if (handoff && current === 'preview') $('preview').focus();
|
|
128
168
|
syncToolbar();
|
|
169
|
+
declareBack();
|
|
129
170
|
}
|
|
130
171
|
|
|
131
172
|
// ---- 工具栏:Mac 用 coda.toolbar,没有的(iOS、harness)退成页内一条 ----
|
|
@@ -140,7 +181,7 @@ const toolbarItems = () => infoOpen ? [] : hasToolbar
|
|
|
140
181
|
// iPhone 树页顶部:返回(仅横屏)、根目录名、⋯。刷新、显示隐藏文件和排序都在 ⋯ 的菜单里。
|
|
141
182
|
// 属性页上只留返回:竖屏有原生导航栏,整条工具条不显示;横屏导航栏隐藏,页面自己给返回(显示与否都由 style.css 的横屏媒体查询决定)。
|
|
142
183
|
const MORE = { id: 'more', label: '更多', kind: 'button', glyph: 'ellipsis', iconOnly: true, menu: true };
|
|
143
|
-
const phoneItems = () => infoOpen ? [EXIT] : [EXIT, { kind: 'title', label: model.ready ?
|
|
184
|
+
const phoneItems = () => infoOpen ? [EXIT] : [EXIT, { kind: 'title', label: model.ready ? dirTitle() : '' }, MORE];
|
|
144
185
|
// 比较键就是要画的项:根目录名变了(换会话)工具条跟着重画。
|
|
145
186
|
let lastItems = '';
|
|
146
187
|
function syncToolbar() {
|
|
@@ -156,34 +197,62 @@ function syncToolbar() {
|
|
|
156
197
|
|
|
157
198
|
// 原生按钮没有 DOM 元素可以当锚点:用一个固定在页面右上角的假锚点,同时也是「谁打开的菜单」的标记。
|
|
158
199
|
const TOOLBAR = { getBoundingClientRect: () => ({ right: window.innerWidth, bottom: 0 }) };
|
|
159
|
-
// 「更多」菜单的内容只写这一处,iPhone 的 ⋯ 和 Mac
|
|
200
|
+
// 「更多」菜单的内容只写这一处,iPhone 的 ⋯ 和 Mac 的原生按钮共用:刷新、显示隐藏文件、「显示」›;「显示」里是视图和排序,当前项有对勾。
|
|
160
201
|
const moreMenu = () => ({ items: [
|
|
161
202
|
{ label: '刷新', run: () => act('refresh') },
|
|
162
203
|
{ label: '显示隐藏文件', checked: model.showHidden, run: () => act('hidden') },
|
|
163
|
-
{
|
|
164
|
-
|
|
165
|
-
|
|
204
|
+
{ label: '显示', submenu: { items: [
|
|
205
|
+
{ heading: '视图' },
|
|
206
|
+
{ label: '列表', checked: model.view === View.LIST, radio: true, run: () => changeView(View.LIST) },
|
|
207
|
+
{ label: '图标', checked: model.view === View.ICONS, radio: true, run: () => changeView(View.ICONS) },
|
|
208
|
+
{ separator: true },
|
|
209
|
+
{ heading: '排序' },
|
|
210
|
+
...Object.values(SortKey).map(key => ({ label: sortName(key), checked: key === model.sort, radio: true, run: () => changeSort(key) })),
|
|
211
|
+
] } },
|
|
166
212
|
] });
|
|
167
213
|
|
|
168
|
-
//
|
|
214
|
+
// 显示的条目或顺序变了、或者换了根目录:旧的滚动位置对不上,待恢复的和上层的记录作废,两种视图都回到顶部。换排序、显示隐藏文件、换根目录都走这里。
|
|
215
|
+
function invalidateScroll() {
|
|
216
|
+
restore.clear();
|
|
217
|
+
trail.clear();
|
|
218
|
+
tree.scrollTo(0);
|
|
219
|
+
grid.scrollTo(0);
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
// 换排序:全局的,存进 persisted。选当前项什么都不做。
|
|
169
223
|
function changeSort(sort) {
|
|
170
224
|
const before = model.sort;
|
|
171
225
|
model.setSort(sort);
|
|
172
226
|
if (model.sort === before) return; // 同值:什么都没换
|
|
173
227
|
persisted.sort = model.sort;
|
|
174
|
-
|
|
175
|
-
|
|
228
|
+
invalidateScroll();
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// 换视图:全局一份,存进 persisted;两种视图各留着自己的内容和滚动位置,换回来还在。
|
|
232
|
+
// 「显示」菜单调用它。
|
|
233
|
+
function changeView(view) {
|
|
234
|
+
const before = model.view;
|
|
235
|
+
model.setView(view);
|
|
236
|
+
if (model.view === before) return;
|
|
237
|
+
persisted.view = model.view;
|
|
238
|
+
menu.hide();
|
|
239
|
+
declareBack();
|
|
240
|
+
schedule();
|
|
176
241
|
}
|
|
177
242
|
|
|
178
243
|
function act(id, button) {
|
|
179
|
-
//
|
|
180
|
-
if (id === EXIT.id) { if (
|
|
244
|
+
// 横屏时导航栏隐藏,原生返回看不到:这里的「返回」和原生返回走同一个退层逻辑,在根层才关视图。
|
|
245
|
+
if (id === EXIT.id) { if (goBack(1)) backPressed = true; else quiet(() => coda.close()); }
|
|
181
246
|
else if (id === 'more') {
|
|
182
247
|
// 键盘激活没有 pointerdown,菜单外点击那条规则不管用:同一个按钮再次激活就关闭。
|
|
183
248
|
if (!menu.hidden && menu.opener === button) menu.hide();
|
|
184
249
|
else menu.open(button, moreMenu());
|
|
185
250
|
}
|
|
186
|
-
else if (id === 'hidden') {
|
|
251
|
+
else if (id === 'hidden') {
|
|
252
|
+
model.setShowHidden(!model.showHidden);
|
|
253
|
+
persisted.hidden = model.showHidden;
|
|
254
|
+
invalidateScroll(); // 不管在哪种视图切换:显示的条目变了,两种视图的旧位置都对不上
|
|
255
|
+
}
|
|
187
256
|
else if (id === 'refresh') {
|
|
188
257
|
conn.refresh();
|
|
189
258
|
model.refresh();
|
|
@@ -206,7 +275,9 @@ function saveNow() {
|
|
|
206
275
|
const top = preview.scroll();
|
|
207
276
|
putSession(persisted, session, {
|
|
208
277
|
...model.snapshot(),
|
|
209
|
-
|
|
278
|
+
// 还没恢复的位置先存它,别存成还没滚过去的 0。
|
|
279
|
+
scroll: { tree: restore.top('tree') ?? tree.scroll(), top: pending.preview?.top ?? top.top, left: pending.preview?.left ?? top.left, sort: model.sort,
|
|
280
|
+
grid: restore.top('grid') ?? grid.scroll(), gridSort: model.sort },
|
|
210
281
|
});
|
|
211
282
|
persisted = trimState(persisted, session);
|
|
212
283
|
// setState 超限会同步抛错:再收紧一次,仍失败就放弃这次,不影响界面。
|
|
@@ -214,15 +285,22 @@ function saveNow() {
|
|
|
214
285
|
}
|
|
215
286
|
quiet(() => coda.on('visibility', visible => { if (!visible) saveNow(); }));
|
|
216
287
|
$('tree').addEventListener('scroll', queueSave, { passive: true });
|
|
288
|
+
$('tree').addEventListener('scroll', () => restore.scrolled('tree'), { passive: true });
|
|
289
|
+
grid.onScroll(queueSave);
|
|
290
|
+
grid.onScroll(() => restore.scrolled('grid'));
|
|
217
291
|
preview.onScroll(queueSave);
|
|
218
292
|
preview.onScroll(menu.hide);
|
|
219
293
|
|
|
220
|
-
// ---- 行菜单:Mac 右键、iPhone 长按;iPhone 的 ⋯ 和 Mac
|
|
294
|
+
// ---- 行菜单:Mac 右键、iPhone 长按;iPhone 的 ⋯ 和 Mac 的原生「更多」出刷新、显示隐藏文件和「显示」(视图、排序)(菜单本身在 menu.mjs)----
|
|
221
295
|
// 行菜单顶上是路径,下面一行 大小 · 完整修改时间(文件夹只有修改时间,读不到就没有这一行);指向外面的链接和不能打开的条目没有元数据,不显示这一行。
|
|
222
296
|
// 不能打开的条目(指向外面或失效的链接、other)没有「添加到聊天」,和不能拖动一致;它们仍有复制路径和属性。
|
|
223
297
|
function pathMenu(event, row) {
|
|
224
298
|
const dead = row.kind === EntryKind.LINK || row.kind === EntryKind.OTHER;
|
|
299
|
+
// Mac 的第一项和双击是同一个动作(右键不改选中);文件夹在列表里写展开或收起,别的写打开。iPhone 轻点就是打开,菜单不变。
|
|
300
|
+
const folder = row.kind === EntryKind.DIR, listed = model.view !== View.ICONS;
|
|
301
|
+
const open = isIOS || dead ? [] : [{ label: folder && listed ? (row.open ? '收起' : '展开') : '打开', run: () => browser().activate(row) }, { separator: true }];
|
|
225
302
|
menu.open(event, { title: row.path, detail: dead ? undefined : infoText(row) || undefined, items: [
|
|
303
|
+
...open,
|
|
226
304
|
...(dead ? [] : [{ label: '添加到聊天', run: () => chat.add(row.path) }]),
|
|
227
305
|
{ label: '复制相对路径', run: () => coda.copy(row.path) },
|
|
228
306
|
{ label: '复制绝对路径', run: () => coda.copy(`${model.root.path}/${row.path}`) },
|
|
@@ -231,26 +309,108 @@ function pathMenu(event, row) {
|
|
|
231
309
|
] });
|
|
232
310
|
}
|
|
233
311
|
$('tree').addEventListener('scroll', menu.hide, { passive: true });
|
|
312
|
+
grid.onScroll(menu.hide);
|
|
313
|
+
|
|
314
|
+
// ---- 键盘(Mac)----
|
|
315
|
+
// 两个作用域各管各的,匹配的键同步 preventDefault,不匹配的不拦;菜单开着不处理,两处都不主动抢焦点。
|
|
316
|
+
// 浏览区:按了键就算用户自己动了,作废这个视图还在等的滚动恢复,即使这次不用滚动;⌘↑ 只有图标视图有(回上一层,同头部的返回),根目录什么都不做。
|
|
317
|
+
function browseKey(event) {
|
|
318
|
+
if (isIOS || !menu.hidden) return;
|
|
319
|
+
const action = browseAction(event), icons = model.view === View.ICONS;
|
|
320
|
+
if (!action || (action === 'parent' && !icons)) return;
|
|
321
|
+
event.preventDefault();
|
|
322
|
+
restore.drop(icons ? 'grid' : 'tree');
|
|
323
|
+
if (action === 'open') browser().openSelected();
|
|
324
|
+
else if (action === 'parent') leaveDir();
|
|
325
|
+
else browser().key(action);
|
|
326
|
+
}
|
|
327
|
+
tree.onKey(browseKey);
|
|
328
|
+
grid.onKey(browseKey);
|
|
329
|
+
// 侧栏预览:只有 ⌘↑,返回。焦点要在面板里才收得到(点正文、打开时交接)。
|
|
330
|
+
$('preview').addEventListener('keydown', event => {
|
|
331
|
+
if (isIOS || infoOpen || !menu.hidden || !previewAction(event)) return;
|
|
332
|
+
event.preventDefault();
|
|
333
|
+
closePreview();
|
|
334
|
+
});
|
|
234
335
|
|
|
235
|
-
// ----
|
|
336
|
+
// ---- 图标视图的进入和返回 ----
|
|
337
|
+
// 进入子目录滚到顶部,先记下上层的位置;回上一层恢复进去之前的位置(记录在内存里,页面卸载后没有,回到顶部)。
|
|
338
|
+
// shownCwd:页面已经处理过的 cwd;它被模型自己换掉(目录没了退到上一层、根目录变了回到根目录)时,在 landed 里补上滚动。
|
|
339
|
+
let shownCwd = '';
|
|
340
|
+
function enterDir(path) {
|
|
341
|
+
trail.remember(model.cwd, grid.scroll());
|
|
342
|
+
selectEntry(null); // 进入新的一层:选中清空
|
|
343
|
+
model.enter(path);
|
|
344
|
+
shownCwd = model.cwd;
|
|
345
|
+
restore.drop('grid');
|
|
346
|
+
grid.scrollTo(0);
|
|
347
|
+
declareBack();
|
|
348
|
+
}
|
|
349
|
+
// 退 levels 层(到根为止);已经在根目录返回 false。
|
|
350
|
+
function leaveDir(levels = 1) {
|
|
351
|
+
if (model.cwd === '') return false;
|
|
352
|
+
const from = model.cwd.split('/');
|
|
353
|
+
model.leave(levels);
|
|
354
|
+
land(trail.take(model.cwd) ?? 0);
|
|
355
|
+
// 选中来时经过的那个文件夹(退到的那一层的直接子项)。目录被删、模型自己退回上层走 landed,不改选中。
|
|
356
|
+
selectEntry(from.slice(0, model.cwd === '' ? 1 : model.cwd.split('/').length + 1).join('/'));
|
|
357
|
+
declareBack();
|
|
358
|
+
return true;
|
|
359
|
+
}
|
|
360
|
+
function land(top) {
|
|
361
|
+
shownCwd = model.cwd;
|
|
362
|
+
grid.scrollTo(0); // 先回到顶部:之后的滚动都是内容变化或用户滚的,恢复据此判断用户有没有动过
|
|
363
|
+
restore.plan('grid', top);
|
|
364
|
+
}
|
|
365
|
+
// 落到哪一层就用哪一层的位置,失效目录待恢复的位置作废。
|
|
366
|
+
function landed() {
|
|
367
|
+
if (model.cwd !== shownCwd) land(trail.take(model.cwd) ?? 0);
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
// ---- 上一层:iPhone 用原生返回,路径只在这里声明 ----
|
|
371
|
+
// 路径是上层的标题,由远到近,不含当前页:图标视图在 a/b 是 [根目录名, 'a'];列表视图没有。属性页多一层当前页:列表视图是 '资源管理器',图标视图是当前目录名。
|
|
372
|
+
// 标题是当前目录名:根目录是根目录名。
|
|
373
|
+
const dirTitle = () => (model.cwd === '' || model.view !== View.ICONS ? rootName(model.root.path) : model.cwd.slice(model.cwd.lastIndexOf('/') + 1));
|
|
374
|
+
function backPath() {
|
|
375
|
+
const icons = model.view === View.ICONS && model.ready;
|
|
376
|
+
const upper = icons && model.cwd !== '' ? [rootName(model.root.path), ...model.cwd.split('/').slice(0, -1)] : [];
|
|
377
|
+
return infoOpen ? [...upper, icons ? dirTitle() : '资源管理器'] : upper;
|
|
378
|
+
}
|
|
379
|
+
let declared = [];
|
|
380
|
+
// 路径没变不重复声明;force:客户端已经退了一层,路径没变也要重新告诉它现在在哪。
|
|
381
|
+
function declareBack(force = false) {
|
|
382
|
+
if (!nativeBack) return;
|
|
383
|
+
const path = backPath();
|
|
384
|
+
if (!force && JSON.stringify(path) === JSON.stringify(declared)) return;
|
|
385
|
+
declared = path;
|
|
386
|
+
quiet(() => coda.back(path));
|
|
387
|
+
}
|
|
388
|
+
// 退 steps 层:先关属性页,再退图标视图的目录;返回是不是真的退了。横屏的返回和原生返回共用。
|
|
389
|
+
function goBack(steps) {
|
|
390
|
+
let used = 0;
|
|
391
|
+
if (infoOpen && steps > used) { closeInfo(); used++; }
|
|
392
|
+
const levels = Math.min(steps - used, model.view === View.ICONS && model.cwd !== '' ? model.cwd.split('/').length : 0);
|
|
393
|
+
if (levels > 0) { leaveDir(levels); used += levels; }
|
|
394
|
+
return used > 0;
|
|
395
|
+
}
|
|
396
|
+
if (nativeBack) quiet(() => coda.on('back', event => {
|
|
397
|
+
if (!goBack(Number.isInteger(event?.steps) && event.steps > 0 ? event.steps : 1)) declareBack(true); // 已经在最上层:重新声明一次
|
|
398
|
+
}));
|
|
399
|
+
|
|
400
|
+
// ---- 属性页:所有关闭的路径(原生返回、横屏的返回、换会话、根目录变化)都重新声明回上层 ----
|
|
236
401
|
function openInfo(row) {
|
|
237
402
|
infoOpen = true;
|
|
238
403
|
info.open(row.path, row);
|
|
239
|
-
|
|
404
|
+
declareBack();
|
|
240
405
|
schedule();
|
|
241
406
|
}
|
|
242
407
|
function closeInfo() {
|
|
243
408
|
if (!infoOpen) return;
|
|
244
409
|
infoOpen = false;
|
|
245
410
|
info.close(); // 在统计的一并取消
|
|
246
|
-
|
|
411
|
+
declareBack();
|
|
247
412
|
schedule();
|
|
248
413
|
}
|
|
249
|
-
// steps 是退几级,属性页只有一级,不论几都回到目录树;已经不在属性页时也重新声明一次根层。
|
|
250
|
-
if (nativeBack) quiet(() => coda.on('back', () => {
|
|
251
|
-
if (infoOpen) closeInfo();
|
|
252
|
-
else quiet(() => coda.back([]));
|
|
253
|
-
}));
|
|
254
414
|
|
|
255
415
|
// ---- 模块的消息(代次和握手由 connection 处理)----
|
|
256
416
|
function onSession(data) {
|
|
@@ -259,29 +419,32 @@ function onSession(data) {
|
|
|
259
419
|
closeInfo();
|
|
260
420
|
menu.hide();
|
|
261
421
|
tree.reset();
|
|
422
|
+
grid.reset();
|
|
262
423
|
epoch++;
|
|
263
424
|
opening = false;
|
|
264
425
|
clearTimeout(unlockTimer);
|
|
265
426
|
hint.hide();
|
|
266
427
|
const saved = persisted.sessions[data.session] ?? null;
|
|
267
|
-
|
|
268
|
-
pending = saved ? { tree: saved.scroll.sort === model.sort ? saved.scroll.tree : 0, preview: { top: saved.scroll.top, left: saved.scroll.left } } : { tree: null, preview: null };
|
|
428
|
+
pending = { preview: saved?.opened ? { top: saved.scroll.top, left: saved.scroll.left } : null };
|
|
269
429
|
model.receive(data, saved);
|
|
430
|
+
trail.clear();
|
|
431
|
+
restore.clear();
|
|
432
|
+
// 两种视图的滚动位置各按当时的排序存;排序是全局的,在别的会话换过就对不上,等内容到了回到顶部。恢复绑定这个会话、根目录、排序和目录。
|
|
433
|
+
tree.scrollTo(0);
|
|
434
|
+
restore.plan('tree', saved && saved.scroll.sort === model.sort ? saved.scroll.tree : 0);
|
|
435
|
+
shownCwd = model.cwd;
|
|
436
|
+
land(saved && saved.scroll.gridSort === model.sort ? saved.scroll.grid : 0);
|
|
270
437
|
}
|
|
271
438
|
|
|
272
439
|
function onRoot(data) {
|
|
273
440
|
const before = model.root;
|
|
274
441
|
if (data.state !== before?.state || data.path !== before?.path) menu.hide(); // 开着的菜单里的路径是旧根目录下的
|
|
275
442
|
if (data.state !== RootState.READY || before?.path !== data.path) closeInfo(); // 属性页看的是旧根目录下的路径
|
|
443
|
+
const scope = model.scope;
|
|
276
444
|
const done = model.receive(data);
|
|
445
|
+
if (model.scope !== scope) invalidateScroll(); // 换了根目录(同根重建不算):旧根目录的位置和记录不能给新的用
|
|
277
446
|
if (done && data.state === RootState.READY) {
|
|
278
|
-
if (before?.path !== data.path) preview.reload(); else preview.refresh();
|
|
279
|
-
const { generation } = conn.link;
|
|
280
|
-
done.then(() => {
|
|
281
|
-
if (conn.link.generation !== generation || pending.tree === null) return;
|
|
282
|
-
tree.scrollTo(pending.tree);
|
|
283
|
-
pending.tree = null;
|
|
284
|
-
});
|
|
447
|
+
if (before?.path !== data.path) { if (model.opened !== null) preview.reload(); } else preview.refresh(); // 换了根目录,opened 已清空:旧预览随即关掉,不再读
|
|
285
448
|
}
|
|
286
449
|
}
|
|
287
450
|
|
|
@@ -293,7 +456,8 @@ function onChanged(data) {
|
|
|
293
456
|
info.refresh();
|
|
294
457
|
}
|
|
295
458
|
|
|
296
|
-
tree.remeasure();
|
|
297
|
-
|
|
459
|
+
const remeasure = () => { tree.remeasure(); grid.remeasure(); };
|
|
460
|
+
remeasure();
|
|
461
|
+
quiet(() => coda.on('theme', remeasure));
|
|
298
462
|
render();
|
|
299
463
|
conn.hello();
|
package/view/chat.mjs
CHANGED
|
@@ -9,13 +9,17 @@ export const MESSAGES = {
|
|
|
9
9
|
added: '已添加到输入框',
|
|
10
10
|
failed: '没能写入输入框,已复制',
|
|
11
11
|
tooLong: '选中内容太长,已复制',
|
|
12
|
+
copyFailed: '没能写入,也没能复制',
|
|
12
13
|
};
|
|
13
14
|
|
|
14
15
|
// link:连接层的 Link;copy(text):复制到剪贴板;hint:view/hint.mjs 的提示。
|
|
15
16
|
export function createChat({ link, copy, hint }) {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
17
|
+
// 等复制的结果再提示:剪贴板同步抛错、异步拒绝都算失败。回来时会话换过了(generation 变了,A→B→A 也算)就什么都不提示,那条提示属于上一个会话。
|
|
18
|
+
const copied = async (text, message) => {
|
|
19
|
+
const { generation } = link;
|
|
20
|
+
let ok = true;
|
|
21
|
+
try { await copy(text); } catch { ok = false; }
|
|
22
|
+
if (link.generation === generation) hint.show(ok ? message : MESSAGES.copyFailed);
|
|
19
23
|
};
|
|
20
24
|
|
|
21
25
|
// block:true 是内容(另起一行),false 是路径和位置(接在后面)。
|