vitepress-plugin-filelist 0.2.3 → 0.3.0

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

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;
@@ -33,6 +34,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 +204,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.