book-index-ui 0.7.2 → 0.7.5

package/dist/index.d.ts

@@ -112,6 +112,8 @@ export declare interface BidUrlProviderProps {
 /** Book 详情 */
 export declare interface BookDetailData extends BaseDetailData {
     type: 'book';
+    /** 刊刻年代（结构化）。优先于从题名现推的结果 */
+    dating?: DatingInfo;
     work_id?: string;
     contained_in?: ContainedInEntry[];
     location_history?: LocationInfo[];
@@ -378,11 +380,7 @@ export declare interface BookPageProps {
 }
 
 export declare function Breadcrumb({ items }: {
-    items: {
-        label: string;
-        onClick?: () => void;
-        href?: string;
-    }[];
+    items: CrumbItem[];
 }): JSX.Element;
 
 export declare interface BucketedResources {
@@ -864,6 +862,18 @@ export declare interface CreateEntityParams {
     inheritData?: Record<string, unknown>;
 }
 
+export declare interface CrumbItem {
+    label: string;
+    onClick?: () => void;
+    href?: string;
+    /**
+     * 内部条目 ID。给了就用 useBidUrl 生成真实 href，
+     * 于是 Ctrl+点击开新标签、右键复制链接都能用——
+     * 只挂 onClick 而 href="#" 的话这些浏览器原生操作全废。
+     */
+    id?: string;
+}
+
 /** 空值占位「—」 */
 export declare function Dash(): JSX.Element;
 
@@ -872,11 +882,85 @@ export declare function DataTable({ children }: {
     children: default_2.ReactNode;
 }): JSX.Element;
 
+/**
+ * 刊刻年代（结构化）。
+ *
+ * 方案见 overview/项目进展/古籍索引网站/整体设计/2026-09-刊刻年代方案.md。
+ *
+ * 背景：97.5% 的版本没有任何年代欄位，页面上的「刊刻年代」此前是
+ * **每次渲染都从题名现推**——无法人工订正，也留不下「这是著录还是猜的」
+ * 的痕迹。这个字段把推断结果落盘，并区分可信度。
+ */
+export declare interface DatingInfo {
+    /** 朝代（归一后：漢/三國/晉/南北朝/隋/唐/五代/宋/遼/西夏/金/元/明/清/民國/日本/朝鮮/高麗/越南/琉球） */
+    era?: string;
+    /** 年号，如「乾隆」「慶元」 */
+    reign?: string;
+    /** 年号第几年 */
+    reign_year?: number;
+    /** 折算后的公元年，供排序 */
+    year?: number;
+    /** 只知「某某間」时给区间，与 year 二选一 */
+    year_range?: [number, number];
+    /** attested 著录 | inferred 推断 | uncertain 存疑 */
+    certainty?: 'attested' | 'inferred' | 'uncertain';
+    /** edition 题名推断 | catalog 书目著录 | colophon 牌记序跋 | manual 人工订正 */
+    source?: 'edition' | 'catalog' | 'colophon' | 'manual';
+    /** 判定依据，一句话 */
+    basis?: string;
+    /** 底本：本版所依据的更早的本子 */
+    based_on?: {
+        era?: string;
+        reign?: string;
+        year?: number;
+        /** 影印 | 翻刻 | 傳鈔 | 配補 | 據刊 */
+        relation?: string;
+        certainty?: 'attested' | 'inferred' | 'uncertain';
+    };
+    /** 后修：本版之后被谁修过版（「元大德刻明修本」的「明修」） */
+    later_repair?: {
+        era?: string;
+    };
+}
+
 export declare const decodeId: typeof base36Decode;
 
 /** Decode an ID string and extract its components. Supports both base36 and legacy base58. */
 export declare function decodeIdString(encoded: string): IdComponents;
 
+/**
+ * 派生关系。全库 1,251 部（6.0%）的题名同时提到两个年代。
+ *
+ * 方向很要紧，两类要分开：
+ *   · 「清覆刊武英殿本」——主体是**清**本，武英殿是它翻刻的**底本**
+ *   · 「元大德刻明修本」——主体是**元**本，明代只是后来**修版**
+ * 用同一套逻辑解析会把主次搞反，故 REPAIR_PATTERNS 单列。
+ */
+export declare type DerivationRelation = '影印' | '翻刻' | '傳鈔' | '配補' | '據刊';
+
+export declare function deriveDating(book: EraInferable): DerivedDating | undefined;
+
+export declare interface DerivedDating {
+    era: string;
+    reign: string;
+    year?: number;
+    yearRange?: YearRange;
+    certainty: 'attested' | 'inferred' | 'uncertain';
+    source: 'catalog' | 'edition';
+    basis: string;
+    /** 底本（本版所依据的更早的本子） */
+    basedOn?: {
+        era: string;
+        reign: string;
+        year?: number;
+        relation: DerivationRelation;
+    };
+    /** 后修：本版之后被谁修过版 */
+    laterRepair?: {
+        era: string;
+    };
+}
+
 export declare interface DerivedEra {
     /** 朝代名（繁体），如「宋」「清」「日本」；推不出时为空串 */
     era: string;
@@ -912,6 +996,17 @@ export declare function deriveEra(book: EraInferable): DerivedEra;
  */
 export declare function deriveYear(book: EraInferable): number | undefined;
 
+/**
+ * 「某某間」的年代區間。
+ *
+ * 「明隆萬間」= 隆慶元年(1567) 至 萬曆末(1620)：取题名里首尾两个年号的起讫。
+ * 「清康雍間」= 康熙元年(1662) 至 雍正末(1735)。
+ * 全库约 60 部这种写法，此前一律推不出年份。
+ *
+ * 区间只用于排序（取下界）与展示，不当确切年份 —— 故与 deriveYear 分开。
+ */
+export declare function deriveYearRange(book: EraInferable): YearRange | undefined;
+
 /** 描述信息 */
 export declare interface DescriptionInfo {
     text: string;
@@ -942,6 +1037,15 @@ export declare function DetailHeader({ title, subtitle, aside, secondLine }: {
 /** IndexDetailData (结构化) → IndexEditorData (扁平化) */
 export declare function detailToEditor(data: IndexDetailData): IndexEditorData;
 
+/**
+ * 作者署名里的 role 显示值。
+ *
+ * 数据里有 16 条 `authors[].role` 写成英文 "author"（录入工具的占位值
+ * 没被替换掉），直接渲染就是「紀昀等編 author」这种中英夹杂。
+ * 这类无信息量的占位值不显示；真正的中文职任（撰/編/總纂官…）原样保留。
+ */
+export declare function displayAuthorRole(role?: string): string;
+
 /** 下载进度信息 */
 export declare interface DownloadProgress {
     status: DownloadStatus;
@@ -1092,12 +1196,19 @@ export declare interface EraInferable {
     edition?: string;
     lineage?: BookDetailData['lineage'];
     publication_info?: BookDetailData['publication_info'];
+    /**
+     * 结构化年代（方案 §3）。给了就直接用，不再从题名现推。
+     *
+     * 这是「优先读 dating、读不到才回退」的入口——旧数据、draft 仓
+     * 未迁移的条目都还没有这个字段，回退保证它们不会坏。
+     */
+    dating?: DatingInfo;
 }
 
 export declare function eraRank(era: string): number;
 
 /** 推断出的朝代及其可信来源 */
-export declare type EraSource = 'lineage' | 'publication' | 'edition' | 'none';
+export declare type EraSource = 'lineage' | 'publication' | 'edition' | 'catalog' | 'none';
 
 /**
  * 可展开行（书目收录 / 考证）：＋/－ 方块 + 主行 + 展开内容。
@@ -2159,6 +2270,8 @@ export declare interface LocaleMessages {
         attachedTexts: string;
         appendix: string;
         containedIn: string;
+        /** 作品被丛编收录（与 belongsToWork 区分：后者指向上级作品） */
+        collectedIn: string;
         belongsToWork: string;
         locationHistory: string;
         historyOverview: string;
@@ -2622,7 +2735,7 @@ export declare interface RelatedEntity {
 export declare interface RelatedGroup {
     key: string;
     /** i18n key，UI 侧翻译 */
-    labelKey: 'belongsToWork' | 'containedWorks' | 'derivativeWorks' | 'studies' | 'relatedWorks';
+    labelKey: 'belongsToWork' | 'collectedIn' | 'containedWorks' | 'derivativeWorks' | 'studies' | 'relatedWorks';
     items: RelatedWorkRef[];
 }
 
@@ -2949,6 +3062,12 @@ declare interface SmartBidInputProps {
 /** Auto-detect base58 or base36 and decode. */
 export declare function smartDecode(s: string): bigint;
 
+/**
+ * 排序用年份：有确切纪年就用，否则退到朝代起始年。
+ * 返回 undefined 表示连朝代都推不出来（「鈔本」「稿本」这类）。
+ */
+export declare function sortYear(book: EraInferable): number | undefined;
+
 export declare const SourceEditor: default_2.FC<SourceEditorProps>;
 
 declare interface SourceEditorProps {
@@ -3264,6 +3383,12 @@ export declare interface VersionRow {
     holders: ResourceEntry[];
     /** current_location.name —— 没有 physical 资源时的回退 */
     locationName?: string;
+    /**
+     * 排序用年份：确切纪年优先，否则退到朝代起始年。
+     * 与 `year` 的区别是它对「宋建安黃善夫家塾刻本」这种只知朝代的
+     * 也给得出值，不至于被扔到清末刻本后面。
+     */
+    sortYear?: number;
     /** 是否重点版本（在 version_graph 核心集内） */
     important: boolean;
     /** 所属分组 id（version_graph.node_groups） */
@@ -3407,4 +3532,15 @@ export declare interface WorkPageProps {
     lineageAction?: default_2.ReactNode;
 }
 
+/**
+ * 「某某間」→ 年代區間。
+ *
+ * 「明隆萬間」= 隆慶元年(1567) 至 萬曆末(1620)：取首尾两个年号的起讫。
+ * 全库约 60 部这种写法。区间只用于排序（取下界）与展示，不当确切年份。
+ */
+export declare interface YearRange {
+    from: number;
+    to: number;
+}
+
 export { }