book-index-ui 0.2.21 → 0.2.23

package/dist/index.d.ts

@@ -382,6 +382,24 @@ declare interface CatalogDivision {
     categories: CatalogCategory[];
 }
 
+/**
+ * 文件名清洗：保留 ASCII 字母数字 + CJK 全范围。
+ *
+ * **必须与 Python 端 storage.py 的 _clean_name 保持一致**，否则同一个
+ * Work/Book 在两侧算路径会差字符 → find_file_by_id 静默 miss。
+ *
+ * 范围（与 Python 一致）：
+ *   - U+3400-U+4DBF   CJK 扩展 A
+ *   - U+4E00-U+9FFF   CJK 基本（注意：旧版只到 U+9FA5）
+ *   - U+F900-U+FAFF   CJK 兼容汉字（U+F98C 歷 等历史字形）
+ *   - U+20000-U+3134F SMP CJK 扩展 B-G
+ *
+ * 历史扫描 book-index-draft 发现 557 个文件名含 CJK 兼容字（U+F900+），
+ * 旧版正则只覆盖到 U+9FA5，会漏掉这些字 — 造成 TS 端算路径与 Python
+ * 写出的路径不一致。
+ */
+export declare function cleanName(name: string): string;
+
 export declare const CollatedEdition: default_2.FC<CollatedEditionProps>;
 
 /** 整理本索引（卷列表） */
@@ -1400,6 +1418,9 @@ export declare interface LineageGraphNode {
     /** 分组 id（来自 work.version_graph.node_groups 或 hypothetical.group） */
     group?: string;
     note?: string;
+    /** 节点上展示的描述（label 之外的副标题，如「繁本，早於嘉靖殘本，已佚」）。
+     *  当前仅 hypothetical 节点透传 hypothetical.description；book 节点暂未使用。 */
+    description?: string;
     /** 桥接节点：本身不在核心集，但为了保持核心节点间派生链不断而引入。
      *  视觉上应淡化（半透明、虚边框）。仅在 collection==='core' 模式下出现。 */
     bridge?: boolean;
@@ -2103,6 +2124,9 @@ declare interface SectionProps {
     children: default_2.ReactNode;
 }
 
+/** Deterministic hash — identical results in Python (h*31+ord(c)) & 0xFFFFFFFF */
+export declare function shardOf(id: string, n?: number): number;
+
 export declare const SmartBidInput: default_2.FC<SmartBidInputProps>;
 
 declare interface SmartBidInputProps {
@@ -2228,6 +2252,9 @@ export declare interface VersionGraphGroup {
 export declare interface VersionGraphHypotheticalNode {
     id: string;
     label: string;
+    /** 节点上展示的副标题/描述（如「繁本，早於嘉靖殘本，已佚」）。
+     *  与 note（学术依据/长说明）区分：description 紧跟在 label 下方显示。 */
+    description?: string;
     year?: number;
     /** 当 year 不明而只有区间时使用 */
     year_range?: [number, number];