knight-ui 1.2.4 → 1.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "knight-ui",
-    "version": "1.2.4",
+    "version": "1.2.6",
     "description": "基于React的Knight-ui前端UI组件库",
     "main": "index.js",
     "module": "index.js",

package/tokens/tokens.css

@@ -856,10 +856,12 @@
    transition: background-color var(--ku-transition-fast);
 }
 
-/* 悬停底原为 fill-0(#14171e), 而弹层底是 bg-2(#14161f) —— 两色几乎同值, 悬停等于没反馈 */
+/* 底走半透明档, 与 .ku-dropdown-item / .ku-menu-option 一致: 下拉面是毛玻璃(.ku-glass-menu),
+   不透明 fill-* 铺上去会把玻璃糊成一片死色 —— 玻璃白做。本行曾走 fill-1, 那时弹层底还是
+   bg-2, 悬停底与它几乎同值(等于没反馈); 换成玻璃档后, 不透明底这条前提整个没了。 */
 .ku-select-option:hover
 {
-   background-color: var(--ku-color-fill-1);
+   background-color: var(--ku-color-fill-translucent-hover);
 }
 
 .ku-select-option.ku-selected
@@ -868,7 +870,8 @@
    background-color: var(--ku-color-primary-light-default);
 }
 
-/* 选中项被悬停时不能被 fill-1 盖掉主色底, 要走主色浅档的下一级 */
+/* 选中项被悬停时不能被悬停底盖掉主色底, 要走主色浅档的下一级(特异性 (0,3,0), 高于上面两条)。
+   与 .ku-menu-option.ku-selected:hover 同档 —— 那条多一个禁用守卫, 这里没有禁用修饰类可挂 */
 .ku-select-option.ku-selected:hover
 {
    background-color: var(--ku-color-primary-light-hover);
@@ -886,6 +889,37 @@
    background-color: var(--ku-color-fill-translucent-hover);
 }
 
+/* ===== 玻璃菜单里的选项行 (Cascader / TreeSelect) =====
+   与 .ku-select-option 是同一件事的两份写法, 悬停 / 激活 / 选中 / 选中悬停四态已逐档对齐 ——
+   见上面 Select 那一组, 两边逐条对照即可。眼下只剩一处结构差异: 这里多一条 .ku-active ——
+   级联的"已展开路径", Select 没有这个概念。将来若并成一份, 只需把 .ku-active 那个选择器捎上。
+   前两条规则特异性都是 (0,2,0), 顺序即优先级: 悬停/激活在前、选中在后, 选中项被悬停时
+   才留得住蓝底; 最后一条 (0,3,0) 再压过前两条, 把悬停中的选中项加深一档。 */
+.ku-menu-option
+{
+   transition: background-color var(--ku-transition-fast);
+}
+
+/* 悬停与"激活"(已展开路径上那一行)同色 —— 两者都是"鼠标或视线正落在这行", 不必区分。
+   与"已选中"的蓝底分工: 中性底 = 正在看, 蓝底 = 选定了 */
+.ku-menu-option:hover:not(.ku-menu-option-disabled),
+.ku-menu-option.ku-active
+{
+   background-color: var(--ku-color-fill-translucent-hover);
+}
+
+.ku-menu-option.ku-selected
+{
+   color: var(--ku-color-primary);
+   background-color: var(--ku-color-primary-light-default);
+}
+
+/* 与 .ku-select-option.ku-selected:hover 同档 —— 选中项也要有悬停反馈, 否则划过与没划过长得一样 */
+.ku-menu-option.ku-selected:hover:not(.ku-menu-option-disabled)
+{
+   background-color: var(--ku-color-primary-light-hover);
+}
+
 /* ===== Modal 对话框 ===== */
 /* 关闭按钮的底色内联没写, 所以这条穿得过去; 但 color 内联恒有值, 悬停改色是白写, 故只留底色。
    底走半透明档: 对话框本身是毛玻璃, 不透明 fill-* 会在玻璃上糊出一片死色。 */

package/utility/AttachmentUtility.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 附件工具 — 只管"文件 → 附件"这一段: 类别判定、校验、缩略图生成与归还。
+ * 内容编码(base64 / 上传)不在这一层, 由调用方按平台处理。
+ */
+export declare namespace AttachmentUtility {
+    /** 附件类别 — 决定缩略图形状与发送时对应的 part 形态 */
+    type Kind = "image" | "file" | "audio" | "video";
+    /** fromFiles 的产物形状 — 各组件的附件模型只要结构兼容即可, 不必绑同一个类型 */
+    interface Item {
+        /** 稳定标识 */
+        id: string;
+        /** 文件名 */
+        name: string;
+        /** 字节数 */
+        size: number;
+        /** MIME */
+        type: string;
+        /** 类别 */
+        kind: Kind;
+        /** 图片缩略图(objectURL), 非图片为空 */
+        thumbnail?: string;
+        /** 原始文件 */
+        file: File;
+    }
+    /** 校验项 */
+    interface FilterOptions {
+        /** 与 <input accept> 同语法: 逗号分隔的后缀 / MIME / "type/*" */
+        accept?: string;
+        /** 是否允许多选, 不传视为允许 */
+        multiple?: boolean;
+        /** 数量上限 */
+        maxCount?: number;
+        /** 单个文件字节上限 */
+        maxSize?: number;
+        /** 已有数量 — 与 maxCount 一起算剩余名额 */
+        count?: number;
+    }
+    /** 被拒的原因 */
+    interface RejectReason {
+        file: File;
+        /** type=类型不符 / size=超体积 / count=超数量或多选受限 */
+        code: "type" | "size" | "count";
+        message: string;
+    }
+    /**
+     * 文件 → 附件; 图片顺带生成缩略图(内存 objectURL, 不用了须 release)
+     * @param files 原始文件
+     * @returns 附件项
+     */
+    function fromFiles(files: Array<File>): Array<Item>;
+    /**
+     * 按 accept / maxSize / maxCount 过一遍 — 被拒的带上原因, 交给调用方去提示
+     * @param files 待校验文件
+     * @param options 校验项
+     * @returns 通过的文件与被拒原因
+     */
+    function filter(files: Array<File>, options?: FilterOptions): {
+        accepted: Array<File>;
+        rejected: Array<RejectReason>;
+    };
+    /**
+     * 归还缩略图占的内存 — 只认本工具生成的 blob: 地址, 调用方自带的 dataURL / 远程地址不动。
+     * 参数只要求 thumbnail 一个字段, 故各组件用自己的附件模型即可
+     * @param attachment 附件
+     */
+    function release(attachment: {
+        thumbnail?: string;
+    }): void;
+    /**
+     * 类别判定 — 先看 MIME, 不可辨时退回后缀
+     * @param file 原始文件
+     * @returns 类别
+     */
+    function kindOf(file: File): Kind;
+    /**
+     * 字节数 → 可读体量
+     * @param size 字节数
+     * @returns 可读字符串
+     */
+    function readSize(size: number): string;
+}

package/utility/index.d.ts

@@ -0,0 +1 @@
+export * from "./AttachmentUtility";