book-index-ui 0.2.19 → 0.2.21

package/dist/index.d.ts

@@ -250,9 +250,10 @@ export declare function buildId(status: IndexStatus, type: IndexType, timestamp:
  *
  * @param work - WorkDetailData（须有 version_graph.enabled === true 才有效）
  * @param books - 与该 Work 关联的 Book 详情数组（应已加载 lineage 字段）
+ * @param collection - 'core' | 'all'，缺省按 vg.default_collection 或 'all'
  * @returns LineageGraph，未启用或无数据时返回空图
  */
-export declare function buildLineageGraph(work: WorkDetailData, books: BookDetailData[]): LineageGraph;
+export declare function buildLineageGraph(work: WorkDetailData, books: BookDetailData[], collection?: 'core' | 'all'): LineageGraph;
 
 /**
  * Bundle 只读 Storage 实现
@@ -1399,6 +1400,9 @@ export declare interface LineageGraphNode {
     /** 分组 id（来自 work.version_graph.node_groups 或 hypothetical.group） */
     group?: string;
     note?: string;
+    /** 桥接节点：本身不在核心集，但为了保持核心节点间派生链不断而引入。
+     *  视觉上应淡化（半透明、虚边框）。仅在 collection==='core' 模式下出现。 */
+    bridge?: boolean;
 }
 
 /** ref_type：派生来源是其他 Book 还是假想节点 */
@@ -2199,6 +2203,17 @@ export declare interface VersionGraph {
     /** Work.books 里但不进图的条目（如待 dedupe 的占位） */
     excluded_books?: string[];
     excluded_reason?: string;
+    /** 集合化展示（核心 vs 完整）：版本繁多的复杂作品（如水浒）适用 */
+    default_collection?: 'core' | 'all';
+    /** 各集合的标签和说明 */
+    collections?: Record<string, {
+        label: string;
+        description?: string;
+    }>;
+    /** 核心集合包含的 book id 列表（缺省时即等同 all） */
+    core_books?: string[];
+    /** 核心集合包含的假想节点 id 列表（缺省时全部假想节点都在核心集） */
+    core_hypotheticals?: string[];
 }
 
 /** Work.version_graph.groups[i] —— 分组/泳道 */
@@ -2281,6 +2296,26 @@ export declare interface VersionLineageViewProps {
     selectedNodeId?: string;
     /** 模式切换回调（用于更新URL） */
     onModeChange?: (mode: 'list' | 'graph') => void;
+    /** 集合切换：'core'（核心）/ 'all'（完整）。仅当 collectionsAvailable 为真时才显示 toggle */
+    collection?: 'core' | 'all';
+    /** 切换集合回调 */
+    onCollectionChange?: (collection: 'core' | 'all') => void;
+    /** 集合元数据（来自 work.version_graph.collections） */
+    collectionsAvailable?: {
+        core?: {
+            label: string;
+            description?: string;
+        };
+        all?: {
+            label: string;
+            description?: string;
+        };
+    };
+    /** 各集合 Book 总数（用于显示徽标，如 "核心 12" "完整 29"） */
+    collectionCounts?: {
+        core?: number;
+        all?: number;
+    };
     className?: string;
     style?: default_2.CSSProperties;
 }