book-index-ui 0.65.0 → 0.65.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -126,12 +126,10 @@ export declare interface BaseDetailData {
126
126
  /** 长篇附记(详情页展示,不进卡片/搜索摘要) */
127
127
  appendix?: AppendixEntry[];
128
128
  authors?: AuthorInfo[];
129
+ /** 别名(字符串);Book 上还可有 {book_title, type:'附刻'}=附刻之书(第 12 组 S2-T 起并入此处) */
129
130
  additional_titles?: (string | {
130
131
  book_title: string;
131
- })[];
132
- /** Book 附载篇目 */
133
- attached_texts?: (string | {
134
- book_title: string;
132
+ type?: string;
135
133
  })[];
136
134
  additional_works?: AdditionalWork[];
137
135
  indexed_by?: IndexedByEntry[];
@@ -153,6 +151,9 @@ export declare interface BaseDetailData {
153
151
  review?: ReviewInfo;
154
152
  /** 存佚:extant 今存 / fragment 殘 / lost 佚 等 */
155
153
  loss_status?: string;
154
+ /** 真偽:只在確定是偽書時寫(唯一值 forged),依據在 authenticity_basis */
155
+ authenticity?: 'forged' | (string & {});
156
+ authenticity_basis?: string;
156
157
  /** 數據修訂號與修訂日期(詳情頁提要卡底部小字) */
157
158
  revision?: number | string;
158
159
  revised_at?: string;
@@ -444,16 +445,6 @@ export declare function bookIndexUriToId(uri: string | null | undefined): string
444
445
 
445
446
  /** Book.lineage —— 单本书的版本节点信息 */
446
447
  export declare interface BookLineage {
447
- /**
448
- * @deprecated 年代已并入 dating(第 1 组),数据里不再有;detail-model 的年份推断仍留着兜底读取,待另行清理。
449
- */
450
- year?: number;
451
- /** @deprecated 同上,见 dating.text */
452
- year_text?: string;
453
- /** @deprecated 同上,见 dating.year_uncertain */
454
- year_uncertain?: boolean;
455
- /** @deprecated 同上,见 dating.year_range */
456
- year_range?: [number, number];
457
448
  /** 存佚(年代见 dating,所出之本见 base_edition,关联见 related_books) */
458
449
  status?: LineageStatus;
459
450
  /** 现存范围说明 */
@@ -1056,6 +1047,8 @@ export declare interface CollatedJuan {
1056
1047
  page_title?: string;
1057
1048
  source_url?: string;
1058
1049
  sections: CollatedSection[];
1050
+ /** 章的其余元数据(第 11 组起 page_title/source_url 等收在这里;读取时经 normalizeCollatedJuan 补到顶层) */
1051
+ meta?: Record<string, unknown>;
1059
1052
  }
1060
1053
 
1061
1054
  /** 整理本参考文献 */
@@ -1098,6 +1091,8 @@ export declare interface CollatedSection {
1098
1091
  header_line?: string;
1099
1092
  /** AI 生成的备注 */
1100
1093
  ai_note?: string;
1094
+ /** 整理过程留下的解析证据(原下划线前缀字段,第 11 组收进这里),阅读器不显示 */
1095
+ evidence?: Record<string, unknown>;
1101
1096
  }
1102
1097
 
1103
1098
  export declare const CollectionCatalog: default_2.FC<CollectionCatalogProps>;
@@ -1885,10 +1880,9 @@ export declare function deriveEditionType(book: EraInferable): string;
1885
1880
  /**
1886
1881
  * 推断一个版本的朝代 / 纪年。
1887
1882
  *
1888
- * 三级回退,越靠前越可信:
1889
- * 1. lineage.year_text —— 人工整理的版本传承信息(仅 1% 有)
1890
- * 2. publication_info.year —— 著录的出版年(仅 2% 有)
1891
- * 3. edition ∥ title 的题名前缀与特征词 —— 覆盖约 96%,但是**推断**
1883
+ * 回退,越靠前越可信:
1884
+ * 1. publication_info.year(含 dating.text 还原)—— 著录的出版年
1885
+ * 2. edition ∥ title 的题名前缀与特征词 —— 覆盖约 96%,但是**推断**
1892
1886
  *
1893
1887
  * UI 必须依 source 区分显示(推断的加 hover 提示),不要让读者误以为
1894
1888
  * 「宋 · 慶元」是著录事实。
@@ -1898,7 +1892,7 @@ export declare function deriveEra(book: EraInferable): DerivedEra;
1898
1892
  /**
1899
1893
  * 推断可排序的公元年份。
1900
1894
  *
1901
- * 优先 lineage.year(人工著录),其次文本里的 4 位公元年,
1895
+ * 优先 dating.year,其次文本里的 4 位公元年,
1902
1896
  * 最后用年号表折算「乾隆四十三年」→ 1736 + 43 - 1 = 1778。
1903
1897
  */
1904
1898
  export declare function deriveYear(book: EraInferable): number | undefined;
@@ -2087,6 +2081,11 @@ export declare interface EntityDetailData extends BaseDetailData {
2087
2081
  _works?: DerivedEntityWork[];
2088
2082
  /** 外部数据库引用(CBDB 等) */
2089
2083
  external_ids?: ExternalIds;
2084
+ /** CBDB 匹配过程元数据(2026-11-04 起,原 external_ids.cbdb_match/cbdb_source) */
2085
+ external_ids_meta?: {
2086
+ cbdb_match?: string;
2087
+ cbdb_source?: string;
2088
+ };
2090
2089
  /** 是否草稿 */
2091
2090
  isDraft?: boolean;
2092
2091
  /** 印影等图(GUJI-538/544):图本体在 book-index-asset,`file` 是仓内相对路径,URL=资源根+file */
@@ -2384,7 +2383,6 @@ export declare interface EntityWorkRef {
2384
2383
  export declare interface EraInferable {
2385
2384
  title?: string;
2386
2385
  edition?: string;
2387
- lineage?: BookDetailData['lineage'];
2388
2386
  publication_info?: BookDetailData['publication_info'];
2389
2387
  /** 目录侧已考定的版本类型(受控词表);有则优先于现推 */
2390
2388
  edition_type?: string;
@@ -2400,7 +2398,7 @@ export declare interface EraInferable {
2400
2398
  export declare function eraRank(era: string): number;
2401
2399
 
2402
2400
  /** 推断出的朝代及其可信来源 */
2403
- export declare type EraSource = 'lineage' | 'publication' | 'edition' | 'catalog' | 'none';
2401
+ export declare type EraSource = 'publication' | 'edition' | 'catalog' | 'none';
2404
2402
 
2405
2403
  /**
2406
2404
  * 可展开行(书目收录 / 考证):+/- 方块 + 主行 + 展开内容。
@@ -2417,6 +2415,7 @@ export declare function ExpandRow({ open, onToggle, main, action, children }: {
2417
2415
  /** Entity.external_ids —— 外部数据库引用 */
2418
2416
  export declare interface ExternalIds {
2419
2417
  cbdb_id?: number;
2418
+ /** 旧位置(2026-11-04 前);现挪到顶层 external_ids_meta,过渡期两处都认 */
2420
2419
  cbdb_match?: string;
2421
2420
  cbdb_source?: string;
2422
2421
  /** 形如 Q123456 */
@@ -3256,6 +3255,12 @@ export declare function ImagePanel({ pages, loading, page: pageProp, onPageChang
3256
3255
  preserveMargins?: boolean;
3257
3256
  }): JSX.Element;
3258
3257
 
3258
+ /**
3259
+ * 宿主自带的取图办法:返回 Promise 就由宿主给图(可以是它现摆正出来的图),返回 null/undefined 走默认的 `<img>` 加载。
3260
+ * 例:海外读者的 Commons 缩略图要先套透视矩阵才和逐字框同一坐标系。Promise 给 null 当作加载失败。
3261
+ */
3262
+ export declare type ImageSourceResolver = (url: string) => Promise<HTMLImageElement | null> | null | undefined;
3263
+
3259
3264
  /**
3260
3265
  * 完整的索引浏览应用:左侧导航 + 右侧详情。
3261
3266
  * 从 demo app (main.tsx) 提取,可直接嵌入任何 React 应用。
@@ -4544,6 +4549,8 @@ declare const NAMESPACES: {
4544
4549
  written: string;
4545
4550
  measure: string;
4546
4551
  loss: string;
4552
+ authenticity: string;
4553
+ forged: string;
4547
4554
  earliest: string;
4548
4555
  emendation: string;
4549
4556
  alias: string;
@@ -6493,6 +6500,8 @@ declare interface SectionProps {
6493
6500
  */
6494
6501
  export declare function segmentEntities(text: string, spans: readonly EntitySpan[], relocateWindow?: number): EntitySegment[];
6495
6502
 
6503
+ export declare function setImageSourceResolver(fn: ImageSourceResolver | null): void;
6504
+
6496
6505
  /** 七阁的分组 key:这一组画成一排方格,其余分组画成列表 */
6497
6506
  export declare const SEVEN_PAVILIONS_KEY = "siku_qige";
6498
6507