vitepress-plugin-filelist 0.7.0 → 0.7.2

package/README.md

@@ -85,6 +85,7 @@ export default {
 | `rememberPassword` | `boolean` | `true` | 输入密码时是否提供“在此标签页中记住”开关；`false` 时不写入 sessionStorage |
 | `pageSize` | `number` | `200` | 每个文件夹先显示的条数，之后显示“显示更多 / 全部显示”；`0` 全部显示 |
 | `deepSearchLimit` | `number` | `500` | 深度搜索每次最多读取的文件夹数，之后可“继续” |
+| `deepSearch` | `'manual' \| 'auto'` | `'manual'` | `auto`：输入关键词即自动深度搜索（适合挂载目录不大的站点） |
 | `zipWarnSize` | `number` | `500`（触屏 `200`） | 需在内存中打包的浏览器（Firefox、Safari）超过该大小（MB）先确认；`0` 不提示 |
 | `zipMaxSize` | `number` | `2048`（触屏 `1024`） | 同上，超过该大小（MB）不打包；`0` 不限制 |
 | `title` | `string` | `''` | 工具栏标题；为空时回退到 OpenList 的 `site_title` |
@@ -148,11 +149,13 @@ interface FileListSource {
 
 ## 筛选与深度搜索
 
-- 输入关键词后立即筛选已加载的内容，显示匹配项及其所在目录，关键词高亮
-- 挂载目录下还有未加载的子文件夹时，列表末尾显示“只筛选了已加载的内容 · 深度搜索”
-- 深度搜索不使用 OpenList 的搜索接口（无需搜索索引）：组件逐个读取未加载的子文件夹（同时 4 个，每次最多 `deepSearchLimit` 个），匹配项边找边出现在原位置，可勾选、打包、预览、下载
-- 搜索中可“停止”；达到上限时显示“继续”；加密文件夹跳过并计数，输入密码后再次深度搜索即可包含
-- 清空关键词回到原来的展开状态，已读取的目录不再重复请求
+- 输入关键词后立即筛选已加载的内容，显示匹配项及其所在目录，关键词高亮；搜索框右侧的 ×（或 Esc）清除筛选，回到原来的展开状态
+- 挂载目录下还有未加载的子文件夹时，列表末尾居中显示“只筛选了已加载的内容，**尝试深度搜索**”
+- 深度搜索不使用 OpenList 的搜索接口（无需搜索索引）：组件逐个读取未加载的子文件夹（同时 4 个，每次最多 `deepSearchLimit` 个），匹配项出现在原位置，可勾选、打包、预览、下载
+- 点过一次即进入**深度搜索状态**，直到清空关键词：更换关键词、刷新、解锁文件夹后都会自动继续，不再出现按钮；刷新时结果保留，读完一次性替换
+- 搜索中可“停止”，达到上限或停止后显示“继续”
+- 深度搜索无法进入的加密文件夹会显示在结果中（带锁，提示“未搜索（需要密码）”），可原地输入密码，解锁后自动搜索其中内容
+- `deep-search="auto"` 时输入关键词即自动进入深度搜索状态
 
 ## 刷新与目录密码
 

package/dist/client/browser/index.d.ts

@@ -102,6 +102,10 @@ interface FileListLabels {
   deepContinue: string;
   deepSkipped: string;
   deepFailed: string;
+  /** Beside a locked folder shown in deep search results. */
+  deepLocked: string;
+  /** The × in the filter box. */
+  clearFilter: string;
   /** Markdown / HTML preview: the source / rendered switch. */
   viewMode: string;
   viewSource: string;
@@ -179,6 +183,11 @@ interface FileListProps {
    * Defaults to `500`.
    */
   deepSearchLimit?: number;
+  /**
+   * `manual` (default): “Try deep search” starts deep search mode.
+   * `auto`: typing a keyword starts it at once (for small mounts).
+   */
+  deepSearch?: 'manual' | 'auto';
   /**
    * Browsers that must build the ZIP in memory (Firefox, Safari) ask first above
    * this many MB. Defaults to 500 (200 on touch devices); `0` never asks.
@@ -216,6 +225,7 @@ declare const _default: import("vue").DefineComponent<FileListProps, {}, {}, {},
   rememberPassword: boolean;
   pageSize: number;
   deepSearchLimit: number;
+  deepSearch: "manual" | "auto";
   locale: FileListLocale;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare global {