book-index-ui 0.2.11 → 0.2.13

package/dist/index.d.ts

@@ -250,6 +250,10 @@ export declare class BundleStorage implements IndexStorage {
     private searchSCache;
     private searchSLoading;
     private searchSLoaded;
+    private metaCache;
+    private metaLoading;
+    /** null = 已尝试加载 meta.json 但失败/缺失（fallback 到 ensureLoaded） */
+    private metaTried;
     private t2sConverter;
     private t2sLoading;
     /** 数据版本（commitId 前 12 位）。null=已尝试加载但失败；undefined=未加载 */
@@ -275,14 +279,24 @@ export declare class BundleStorage implements IndexStorage {
     /** Load chunk for a specific ID using manifest-based prefix resolution */
     private loadChunkForId;
     private loadTiyaoGroup;
+    /**
+     * 获取轻量元数据（< 1 KB）。优先读 /data/meta.json；
+     * 若该文件不存在（旧 bundle），回退到 ensureLoaded 计算。
+     */
+    getCounts(): Promise<IndexCounts>;
     getResourceCounts(): Promise<{
         hasText: number;
         hasImage: number;
     }>;
+    getSubtypeStats(): Promise<Record<string, number>>;
     loadEntries(type: IndexType, options: LoadOptions): Promise<PageResult<IndexEntry>>;
     search(query: string, type: IndexType, options: LoadOptions): Promise<PageResult<IndexEntry>>;
     searchAll(query: string, limit?: number): Promise<GroupedSearchResult>;
     getItem(id: string): Promise<Record<string, unknown> | null>;
+    /**
+     * 优先用 chunk 构造 IndexEntry，避免触发 ensureLoaded() 拉全量 index.json。
+     * 旧 bundle 没有把 has_collated 等字段注入 chunk 时回退到 ensureLoaded。
+     */
     getEntry(id: string): Promise<IndexEntry | null>;
     getAllEntries(): Promise<IndexEntry[]>;
     saveItem(): Promise<{
@@ -975,6 +989,18 @@ declare interface IndexBrowserProps {
     headerRight?: default_2.ReactNode;
 }
 
+declare interface IndexCounts {
+    works: number;
+    books: number;
+    collections: number;
+    entities: number;
+    resourceCounts?: {
+        hasText: number;
+        hasImage: number;
+    };
+    subtypeStats?: Record<string, number>;
+}
+
 export declare const IndexDetail: default_2.FC<IndexDetailProps>;
 
 /** 统一详情数据类型 */
@@ -1228,6 +1254,14 @@ export declare interface IndexStorage {
     }>;
     /** 获取 Work subtype 细分统计 */
     getSubtypeStats?(): Promise<Record<string, number>>;
+    /**
+     * 一次性获取索引规模 + 资源 + subtype 统计的轻量元数据。
+     *
+     * 用于代替 getAllEntries() / loadEntries(t,{page:1,pageSize:1}) ×4 等
+     * "为了几个数字下载整个 index" 的场景。BundleStorage 实现读取
+     * /data/meta.json（< 1 KB），其它实现可选。
+     */
+    getCounts?(): Promise<IndexCounts>;
 }
 
 /** 索引类型 */