apes-sidebar

254 Commits 6 Branches 43 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
Atlas Zeng	6ee1ba11d0	feat(editor): 文件窗口与资源管理器二合一 + 声明式设置 select 行 (#151 ) * feat(editor): merged explorer mode — path input, docked file tree, global name search New editorExplorer pref (default on, editor card gear): the editor tab gains a path-input header and a toggleable right-docked tree panel (per-tab state in tab.meta.treeOpen; file tabs default closed, the seeded path-less home tab defaults open). Fresh sessions seed that empty editor tab instead of the explorer tab when merged mode is on; the standalone explorer tab stays in the + menu unchanged. - Extract FileTree.tsx from ExplorerView (shared by both hosts) - Host fs.search route: recursive case-insensitive name search rooted at the session cwd, budget-capped (200 matches / 100k visited), skips .git, never descends symlink dirs - EditorHost reads the pref reactively (boolean snapshot) and keeps the pre-merge layout verbatim when off * feat(settings): select row type for declarative settings; editorExplorer as iconed select - SidebarSettingToggle gains type 'select' with options {value,title,desc,icon} and multi (default false; stores the picked values as an array in options order). Any option carrying an icon renders big-icon option cards in the dropdown and the icon in the closed anchor; icon-less rows are one-line text. - SelectRow in SideCardSection rides the primitives Menu (portal); single-pick commits and closes, multi toggles and stays open. Wired for both host-prefs toggles and plugin-owned pluginToggles via the new onSelectValue seam. - The editorExplorer merged-mode pref is now an iconed select (merged vs separate) instead of a switch; the stored value stays boolean. - Advertise the capability as 'settingSelect' in SIDEBAR_FEATURES. * feat(editor): unify explorer into the editor surface, resizable tree dock, hoisted toolbar - One tree implementation, two presentations: the shared TreePanel (global name search + refresh + FileTree) docks as the editor tab's right panel and — in merged mode — fills the explorer tab's window; the pref-off explorer keeps its legacy header shell. - The docked panel drag-resizes from its left edge (160-480px clamp), persisted as tab.meta.treeWidth alongside treeOpen. - The text editor's preview/edit/save toolbar moves into the path-input header row: FileViewerProps gains internal toolbar fields ('host' mode skips the viewer's own row, reports EditorToolbarState and registers EditorToolbarControls); non-merged mode is byte-identical to before. * feat(editor): single files window with in-place switching; explorer descriptor removed - editor tab replaces explorer on the + menu (order 10, Files); persisted explorer tabs migrate to the editor home tab via sanitizeState - editorExplorer now only controls open behavior: merged = in-place updateTab, independent = openSidebarFile; both modes share the merged chrome (path input + hoisted preview/edit/save toolbar + tree toggle) - file tree context menu gains 'open in new tab' / 'open to the side' (mintTabId avoids the id safety net; insertLeafAt splits right) - tree dock resize uses pointer capture (touch-action none, 6px handle) - defaults: openByDefault off, sidebar width 35% - file tree clips horizontal overflow (no sideways scroll) - e2e: mount lane arms the editor-chunk wait before goto and clicks the tree row's left edge (hover @-reference button sits mid-row); drag lane expands the panel first (collapsed push writes 0px), waits for the slide-in to settle, and picks the leftmost col-resize strip; 'Files' title assertions require draggable to skip the bottom panel's welcome cards * feat(editor): split mode turns the path-less window into the standalone explorer In independent (split) mode a path-less files window renders ONLY the tree panel (search + FileTree, full-window form) — no path input, no hoisted toolbar, no tree toggle. File clicks open per-path editor tabs (full chrome, tree docked closed by default) through openSidebarFile, unchanged. Merged mode is untouched (chrome + docked tree, in-place switching). TreePanel's previously reserved 'full' prop now has its consumer.	2026-08-17 15:00:03 +08:00
Menghuan1918	82a69546d2	feat: 公共 API 基座化（v0.12.0，纯增量）— 类型/能力/设置 seam 全面补齐 - 类型生态：service 模块 re-export SidebarTab/SidebarState/SidebarStore/ SidebarSnapshot/SidebarDiffRef/TabType/SessionScope/SidebarPrefs 等公共状态词汇（此前 TS2459 无法命名）；context-types 去 Node 依赖（结构镜像 SidebarHttpRequest/Response/UpgradeSocket/Head），client 可达声明图零 node:* 引用，外部消费者无 @types/node + skipLibCheck:false 可编译（scripts/check-consumer-types.sh 守护） - 服务能力：version/features 版本与能力探测（单调只增）、getSnapshot/ subscribeState 状态订阅、updateTab（title/path/meta）、activateTab、 openFile（路径派生 id 与内置拦截一致）、openTab(seed, scope?) 定向到指定 session（store.reduceFor 不扰动 UI） - TabDescriptor：badge 角标（99+ 封顶，抛错吞掉）、onOpen/onActivate/ onClose 生命周期回调（service 路径派发，dedupe 聚焦触发 onActivate 而非 onOpen，抛错不打断流程）；SidebarTab.meta JSON 可序列化跨刷新持久化（sanitize 宽松保留） - 设置 seam 开放：PrefsSchema 增 pluginSettings 开放嵌套 map（z.dict）， settings.pluginToggles（插件自有行，同 switch/text/number 控件）与 settings.render（自定义面板，含 store/service/prefs/updatePluginSetting/ close props）；viewer 卡片 v0.12.0 起也有齿轮设置弹窗 - FileViewerDescriptor.load 增第三参 AbortSignal（EditorHost 生命周期中止） - UI 接线：tab 激活/关闭改走 service（跨树激活修复 + 回调触发）、+ 菜单传 scope、TabBar badge pill 渲染；active-session scope 走原 reduce 路径保证 notify - 测试 +23：生命周期/定向打开/updateTab/activateTab/openFile/meta 持久化/ reduceFor/能力常量（与 package.json 锁步）、consumer-types.ts 编译门、 api-surface.spec.ts（client 图零 node 依赖守护）；既有 430 测试全绿 - 文档：AGENTS.md 修 available 三参示例并补全部新 API；external-plugin- guide.md 刷新至 v0.12.0（7 tab + 9 viewer、设置 seam 开放、类型导入路径建议）；README×2 服务化小节同步未发版 npm（用户决定）；分支 feat/plugin-api-v012。	2026-08-14 20:44:43 +08:00
Menghuan1918	0467101faf	feat(editor): 拆分 EditorHost/TextEditor — code/markdown 成为注册 viewer，fs.read 增加 head 字节 - 新 src/client/EditorHost.tsx：'editor' tab 组件。matchFileViewer → 按 fetchStrategy 分发（纯逻辑在 editor-load.ts）→ 渲染 viewer.component； binary 无匹配时渲染共享 BinaryDownload。标题栏保留在 host - 新 src/client/TextEditor.tsx：code/markdown 的 viewer 组件（CodeMirror + 保存/脏点/截断横幅 + md 预览/编辑切换），内容由 host 经 fsRead 传入，自身不再 fetch；按 viewerId === 'markdown' 分支（不再解析扩展名） - 新 src/client/editor-load.ts：planFirstMatch / planFsReadOutcome / decodeHead 纯函数，策略分发可单测 - 新 src/client/binary-download.tsx：共享下载兜底组件（viewer 注册与 host fallback 同一 UI） - host src/index.ts：fs.read 二进制响应增加 head 字段（base64，前 4KB，唯一 host 触碰，设计文档 detect 机制所需）；客户端 FsBinaryResult 同步 - builtins：注册 8 个 viewer（新增 markdown exts md/markdown、code catch-all -100）；binary-download 增加 NUL detect + 复用 BinaryDownload - 删除 src/client/EditorView.tsx（职责一分为二）；陈旧注释同步 - 新增 tests/editor-load.spec.ts（12 用例）	2026-08-11 11:16:36 +08:00

Author

SHA1

Message

Date

Atlas Zeng

6ee1ba11d0

feat(editor): 文件窗口与资源管理器二合一 + 声明式设置 select 行 (#151 )

* feat(editor): merged explorer mode — path input, docked file tree, global name search

New editorExplorer pref (default on, editor card gear): the editor tab gains
a path-input header and a toggleable right-docked tree panel (per-tab state
in tab.meta.treeOpen; file tabs default closed, the seeded path-less home
tab defaults open). Fresh sessions seed that empty editor tab instead of
the explorer tab when merged mode is on; the standalone explorer tab stays
in the + menu unchanged.

- Extract FileTree.tsx from ExplorerView (shared by both hosts)
- Host fs.search route: recursive case-insensitive name search rooted at
  the session cwd, budget-capped (200 matches / 100k visited), skips .git,
  never descends symlink dirs
- EditorHost reads the pref reactively (boolean snapshot) and keeps the
  pre-merge layout verbatim when off

* feat(settings): select row type for declarative settings; editorExplorer as iconed select

- SidebarSettingToggle gains type 'select' with options {value,title,desc,icon}
  and multi (default false; stores the picked values as an array in options
  order). Any option carrying an icon renders big-icon option cards in the
  dropdown and the icon in the closed anchor; icon-less rows are one-line text.
- SelectRow in SideCardSection rides the primitives Menu (portal); single-pick
  commits and closes, multi toggles and stays open. Wired for both host-prefs
  toggles and plugin-owned pluginToggles via the new onSelectValue seam.
- The editorExplorer merged-mode pref is now an iconed select (merged vs
  separate) instead of a switch; the stored value stays boolean.
- Advertise the capability as 'settingSelect' in SIDEBAR_FEATURES.

* feat(editor): unify explorer into the editor surface, resizable tree dock, hoisted toolbar

- One tree implementation, two presentations: the shared TreePanel (global
  name search + refresh + FileTree) docks as the editor tab's right panel
  and — in merged mode — fills the explorer tab's window; the pref-off
  explorer keeps its legacy header shell.
- The docked panel drag-resizes from its left edge (160-480px clamp),
  persisted as tab.meta.treeWidth alongside treeOpen.
- The text editor's preview/edit/save toolbar moves into the path-input
  header row: FileViewerProps gains internal toolbar fields ('host' mode
  skips the viewer's own row, reports EditorToolbarState and registers
  EditorToolbarControls); non-merged mode is byte-identical to before.

* feat(editor): single files window with in-place switching; explorer descriptor removed

- editor tab replaces explorer on the + menu (order 10, Files); persisted
  explorer tabs migrate to the editor home tab via sanitizeState
- editorExplorer now only controls open behavior: merged = in-place
  updateTab, independent = openSidebarFile; both modes share the merged
  chrome (path input + hoisted preview/edit/save toolbar + tree toggle)
- file tree context menu gains 'open in new tab' / 'open to the side'
  (mintTabId avoids the id safety net; insertLeafAt splits right)
- tree dock resize uses pointer capture (touch-action none, 6px handle)
- defaults: openByDefault off, sidebar width 35%
- file tree clips horizontal overflow (no sideways scroll)
- e2e: mount lane arms the editor-chunk wait before goto and clicks the
  tree row's left edge (hover @-reference button sits mid-row); drag lane
  expands the panel first (collapsed push writes 0px), waits for the
  slide-in to settle, and picks the leftmost col-resize strip; 'Files'
  title assertions require draggable to skip the bottom panel's welcome
  cards

* feat(editor): split mode turns the path-less window into the standalone explorer

In independent (split) mode a path-less files window renders ONLY the
tree panel (search + FileTree, full-window form) — no path input, no
hoisted toolbar, no tree toggle. File clicks open per-path editor tabs
(full chrome, tree docked closed by default) through openSidebarFile,
unchanged. Merged mode is untouched (chrome + docked tree, in-place
switching). TreePanel's previously reserved 'full' prop now has its
consumer.

2026-08-17 15:00:03 +08:00

Menghuan1918

82a69546d2

feat: 公共 API 基座化（v0.12.0，纯增量）— 类型/能力/设置 seam 全面补齐

- 类型生态：service 模块 re-export SidebarTab/SidebarState/SidebarStore/
  SidebarSnapshot/SidebarDiffRef/TabType/SessionScope/SidebarPrefs 等公共
  状态词汇（此前 TS2459 无法命名）；context-types 去 Node 依赖（结构镜像
  SidebarHttpRequest/Response/UpgradeSocket/Head），client 可达声明图零
  node:* 引用，外部消费者无 @types/node + skipLibCheck:false 可编译
  （scripts/check-consumer-types.sh 守护）
- 服务能力：version/features 版本与能力探测（单调只增）、getSnapshot/
  subscribeState 状态订阅、updateTab（title/path/meta）、activateTab、
  openFile（路径派生 id 与内置拦截一致）、openTab(seed, scope?) 定向到
  指定 session（store.reduceFor 不扰动 UI）
- TabDescriptor：badge 角标（99+ 封顶，抛错吞掉）、onOpen/onActivate/
  onClose 生命周期回调（service 路径派发，dedupe 聚焦触发 onActivate
  而非 onOpen，抛错不打断流程）；SidebarTab.meta JSON 可序列化跨刷新
  持久化（sanitize 宽松保留）
- 设置 seam 开放：PrefsSchema 增 pluginSettings 开放嵌套 map（z.dict），
  settings.pluginToggles（插件自有行，同 switch/text/number 控件）与
  settings.render（自定义面板，含 store/service/prefs/updatePluginSetting/
  close props）；viewer 卡片 v0.12.0 起也有齿轮设置弹窗
- FileViewerDescriptor.load 增第三参 AbortSignal（EditorHost 生命周期中止）
- UI 接线：tab 激活/关闭改走 service（跨树激活修复 + 回调触发）、+ 菜单
  传 scope、TabBar badge pill 渲染；active-session scope 走原 reduce 路径
  保证 notify
- 测试 +23：生命周期/定向打开/updateTab/activateTab/openFile/meta 持久化/
  reduceFor/能力常量（与 package.json 锁步）、consumer-types.ts 编译门、
  api-surface.spec.ts（client 图零 node 依赖守护）；既有 430 测试全绿
- 文档：AGENTS.md 修 available 三参示例并补全部新 API；external-plugin-
  guide.md 刷新至 v0.12.0（7 tab + 9 viewer、设置 seam 开放、类型导入
  路径建议）；README×2 服务化小节同步

未发版 npm（用户决定）；分支 feat/plugin-api-v012。

2026-08-14 20:44:43 +08:00

Menghuan1918

0467101faf

feat(editor): 拆分 EditorHost/TextEditor — code/markdown 成为注册 viewer，fs.read 增加 head 字节

- 新 src/client/EditorHost.tsx：'editor' tab 组件。matchFileViewer →
  按 fetchStrategy 分发（纯逻辑在 editor-load.ts）→ 渲染 viewer.component；
  binary 无匹配时渲染共享 BinaryDownload。标题栏保留在 host
- 新 src/client/TextEditor.tsx：code/markdown 的 viewer 组件（CodeMirror +
  保存/脏点/截断横幅 + md 预览/编辑切换），内容由 host 经 fsRead 传入，
  自身不再 fetch；按 viewerId === 'markdown' 分支（不再解析扩展名）
- 新 src/client/editor-load.ts：planFirstMatch / planFsReadOutcome /
  decodeHead 纯函数，策略分发可单测
- 新 src/client/binary-download.tsx：共享下载兜底组件（viewer 注册与
  host fallback 同一 UI）
- host src/index.ts：fs.read 二进制响应增加 head 字段（base64，前 4KB，
  唯一 host 触碰，设计文档 detect 机制所需）；客户端 FsBinaryResult 同步
- builtins：注册 8 个 viewer（新增 markdown exts md/markdown、code
  catch-all -100）；binary-download 增加 NUL detect + 复用 BinaryDownload
- 删除 src/client/EditorView.tsx（职责一分为二）；陈旧注释同步
- 新增 tests/editor-load.spec.ts（12 用例）

2026-08-11 11:16:36 +08:00