vitepress-plugin-filelist 0.2.3 → 0.3.1

package/README.md

@@ -10,6 +10,8 @@
 - ⬇️ 单文件下载与预览（`/d/`、`/p/`、`fs/get` 的 `raw_url`）
 - 🔐 目录密码输入，可选只读 token
 - 🔎 当前树过滤，按名称 / 大小 / 日期排序
+- 🎨 紧凑表格：按文件类型着色的扩展名标签、层级引导线，跟随 VitePress 亮 / 暗主题
+- 📱 窄容器（< 560px）自动切换为双行列表与 44px 触控区，勾选后工具栏变为吸顶操作条
 - 🌐 使用 `/api/fs/list`、`/api/fs/get`、`/api/public/settings`
 - 🧪 `base` 为空时使用内置演示数据
 - SSR 安全（网络请求只在客户端执行）
@@ -112,6 +114,24 @@ interface FileListSource {
 }
 ```
 
+## 界面与布局
+
+- 宽容器：表格布局（勾选 / 名称 / 大小 / 修改日期 / 操作），行高 40px；勾选文件后，工具栏原地变为操作条（已选数量、总大小、清除、下载 ZIP）
+- 窄容器（组件宽度 < 560px，基于容器查询而非视口宽度，侧边栏挤压时同样生效）：
+  - 隐藏“修改日期”列，大小与日期显示在文件名下方
+  - 行高 56px，复选框、展开、预览、下载的触控区不小于 44px
+  - 表头排序改为下拉选择
+  - 勾选后操作条吸附在组件顶部，位于 VitePress 导航栏 / “On this page” 栏下方，只在本组件范围内吸附
+- 颜色全部取自 VitePress 主题变量，暗色模式自动适配
+
+吸顶偏移默认根据 `.VPNav`、`.VPLocalNav` 的实际高度自动计算；自定义主题可手动指定：
+
+```css
+.fl-root {
+  --fl-sticky-top: 56px;
+}
+```
+
 ## 国际化
 
 ```md
@@ -181,7 +201,7 @@ Deno 可以安装 npm 依赖，但目前用 Deno 构建 VitePress 会在 rolldow
 ## 说明
 
 - 批量 ZIP 通过 `raw_url`（OpenList `/p/` 代理）下载，CORS 保持在 OpenList 源上
-- 表头全选只统计已加载的文件，页脚会显示还有多少文件夹未展开；勾选单个文件夹则会递归加载其全部子目录（目录很深或很多时会逐个请求，可能较慢）
+- 表头全选只统计已加载的文件；勾选单个文件夹则会递归加载其全部子目录（目录很深或很多时会逐个请求，可能较慢）
 - 目录以 `per_page: 0` 请求全部条目；超大目录可能较慢，暂未实现分页
 
 ## 开发

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

@@ -6,6 +6,7 @@ interface FileListLabels {
   filter: string;
   refresh: string;
   batch: string;
+  /** @deprecated No longer shown; the selection count lives in the toolbar. */
   batchCount: string;
   batching: string;
   passwordPrompt: string;
@@ -24,6 +25,7 @@ interface FileListLabels {
   download: string;
   loaded: string;
   selected: string;
+  /** @deprecated No longer shown; the footer only shows loaded files and size. */
   unloaded: string;
   folderFailed: string;
   demoDownload: string;
@@ -33,6 +35,23 @@ interface FileListLabels {
   previewFailed: string;
   batchFailed: string;
   defaultZip: string;
+  /** Text button that clears the selection (wide layout). */
+  clear: string;
+  /** Accessible name of the clear-selection button. */
+  clearSelection: string;
+  /** `{size}` total, used for the selection and the footer. */
+  totalSize: string;
+  /** `{count}` files inside a loaded folder. */
+  folderItems: string;
+  /** Label of the compact sort select shown in narrow containers. */
+  sortBy: string;
+  selectAll: string;
+  /** Accessible name of a row checkbox, `{name}`. */
+  selectItem: string;
+  /** Accessible name of the expand button, `{name}`. */
+  expand: string;
+  /** Accessible name of the collapse button, `{name}`. */
+  collapse: string;
 }
 interface FileListSource {
   /** OpenList path, directory or single file. */
@@ -186,6 +205,13 @@ export declare function uniqueEntryName(name: string, used: Set<string>): string
 export declare function formatSize(size: number): string;
 export declare function formatDate(iso: string): string;
 export declare function extOf(name: string): string;
+export type FileKind = 'doc' | 'sheet' | 'slide' | 'pdf' | 'image' | 'media' | 'archive' | 'code' | 'other';
+/** Rough file family, used to colour the type badge. */
+export declare function fileKind(name: string): FileKind;
+/** Sum of the `size` of the given entries, ignoring missing or invalid sizes. */
+export declare function totalSize(items: Array<{
+  size?: number;
+}>): number;
 export declare function compareNodes(a: SortableNode, b: SortableNode, key: SortKey, ascending?: boolean): number;
 /**
  * Register `<FileList>` and `<VPFileList>` globally.