book-index-ui 0.2.0 → 0.2.3

package/dist/index.d.ts

@@ -50,6 +50,10 @@ export declare interface BaseDetailData {
     publication_info?: PublicationInfo;
     current_location?: LocationInfo;
     juan_count?: JuanCount;
+    /** 多維計量（卷、回、集等），適合通俗小說等 */
+    measures?: Measure[];
+    /** UI 直接展示的計量文本，應與 measures 一致 */
+    measure_info?: string;
     page_count?: PageCount;
     resources?: ResourceEntry[];
 }
@@ -69,6 +73,15 @@ export declare class BidLink {
     static isBidLink(url: string): boolean;
 }
 
+export declare type BidUrlBuilder = (id: string) => string;
+
+export declare function BidUrlProvider({ buildUrl, children }: BidUrlProviderProps): JSX.Element;
+
+export declare interface BidUrlProviderProps {
+    buildUrl: BidUrlBuilder;
+    children: default_2.ReactNode;
+}
+
 /** Book 详情 */
 export declare interface BookDetailData extends BaseDetailData {
     type: 'book';
@@ -314,12 +327,33 @@ export declare const CollatedEdition: default_2.FC<CollatedEditionProps>;
 
 /** 整理本索引（卷列表） */
 export declare interface CollatedEditionIndex {
+    /** 整理本类型：catalog（目录志书）| kaozhen（考证） */
+    type?: 'catalog' | 'kaozhen';
     work_id: string;
-    total_juan: number;
-    juan_files: string[];
+    total_juan?: number;
+    juan_files?: string[];
     juan_groups?: JuanGroup[];
     /** 参考文献 */
     references?: CollatedReference[];
+    /** kaozhen: 考证对象（如"漢書藝文志"） */
+    target_source?: string;
+    target_source_id?: string;
+    /** kaozhen: 文本来源说明 */
+    text_source?: string;
+    /** 文本质量等级 */
+    text_quality?: {
+        grade: TextQualityGrade;
+        /** 文字来源说明 */
+        source_note?: string;
+    };
+    /** 文件列表（替代 juan_files 的详细版） */
+    files?: Array<{
+        filename: string;
+        title: string;
+        source_juan?: string;
+        sections?: number;
+        status?: string;
+    }>;
 }
 
 export declare interface CollatedEditionProps {
@@ -362,8 +396,8 @@ declare interface CollatedReference {
 /** 整理本中的一个 section */
 export declare interface CollatedSection {
     title: string;
-    level: number;
-    type: '部' | '类' | '书' | '其他';
+    level?: number;
+    type: string;
     content?: string;
     edition?: string | null;
     text_status?: string | null;
@@ -379,7 +413,14 @@ export declare interface CollatedSection {
     author_type?: string | null;
     note?: string | null;
     tag?: string | null;
+    /** catalog 类型：单个关联作品 ID */
     work_id?: string | null;
+    /** kaozhen 类型：关联的作品 ID 列表 */
+    work_ids?: string[];
+    /** kaozhen 类型：原文标题行 */
+    header_line?: string;
+    /** AI 生成的备注 */
+    ai_note?: string;
 }
 
 export declare const CollectionCatalog: default_2.FC<CollectionCatalogProps>;
@@ -709,6 +750,16 @@ export declare class GithubStorage implements IndexStorage {
     }>;
     deleteItem(): Promise<void>;
     generateId(): Promise<string>;
+    /** 通过已知路径获取 item JSON */
+    private fetchItemByPath;
+    /**
+     * 通过 ID 推导路径查找文件（不依赖 index）。
+     * 文件路径格式: {Type}/{c1}/{c2}/{c3}/{id}-{title}.json
+     * 从 ID 可解析出 type 和 status（决定 repo），用 GitHub Contents API 列出目录找到匹配文件。
+     */
+    private findItemById;
+    /** 从 item 元数据构建 IndexEntry */
+    private buildEntryFromItem;
     /** 通过相对路径获取文件（自动尝试 GitHub raw + CDN fallback） */
     private fetchFile;
     /** 获取条目对应的 repo 和目录信息 */
@@ -959,6 +1010,8 @@ export declare interface IndexEntry {
     has_image?: boolean;
     /** 是否有整理本 */
     has_collated?: boolean;
+    /** 作品子类型：poem / article / book（默认） */
+    subtype?: string;
 }
 
 /** index.json 结构 */
@@ -984,6 +1037,8 @@ export declare interface IndexFileEntry {
     attached_texts?: string[];
     edition?: string;
     juan_count?: number;
+    /** UI 展示用計量文本，優先於 juan_count 單獨顯示 */
+    measure_info?: string;
     has_text?: boolean;
     has_image?: boolean;
 }
@@ -1066,6 +1121,8 @@ export declare interface IndexStorage {
         hasText: number;
         hasImage: number;
     }>;
+    /** 获取 Work subtype 细分统计 */
+    getSubtypeStats?(): Promise<Record<string, number>>;
 }
 
 /** 索引类型 */
@@ -1286,6 +1343,9 @@ export declare interface LocaleMessages {
         recentBrowse: string;
         history: string;
         clearAll: string;
+        clearRecent: string;
+        itemNotFound: string;
+        removeFromRecent: string;
         searchTitle: string;
         searchSubtitle: string;
         searchBookName: string;
@@ -1439,6 +1499,8 @@ export declare interface LocaleToggleProps {
 export declare class LocalStorage implements IndexStorage {
     private storage;
     private idGen;
+    private fs;
+    private workspaceRoot;
     private recentEntities;
     constructor(config: LocalStorageConfig);
     loadEntries(type: IndexType, options: LoadOptions): Promise<PageResult<IndexEntry>>;
@@ -1463,6 +1525,7 @@ export declare class LocalStorage implements IndexStorage {
     getRecentEntities(): Promise<EntityOption[]>;
     addRecentEntity(entity: EntityOption): Promise<void>;
     getCollectionCatalog(collectionId: string): Promise<VolumeBookMapping | null>;
+    getRecommended(): Promise<RecommendedData | null>;
     /** 获取资源目录路径（不创建） */
     getAssetDir(idStr: string): string;
     /** 初始化资源目录，返回路径 */
@@ -1498,6 +1561,14 @@ export declare interface LocationInfo {
     description?: string;
 }
 
+/** 單個計量單位（卷、回、集、篇、則 等） */
+declare interface Measure {
+    unit: string;
+    number: number;
+    /** 計量相關備註，如 "每集五回" */
+    note?: string;
+}
+
 export declare class MigrationError extends BookIndexError {
     constructor(message?: string);
 }
@@ -1788,6 +1859,11 @@ export declare interface SyncConfig {
 
 declare type TabKey = 'recommend' | 'catalog' | 'site' | 'feedback';
 
+/** 整理本文本质量等级 */
+declare type TextQualityGrade = 'published' | 'fine' | 'rough' | 'ocr';
+
+export declare function useBidUrl(): BidUrlBuilder;
+
 /**
  * 古籍内容繁简转换 hook
  * 繁体模式下原样返回，简体模式下通过 opencc-js 转换