book-index-ui 0.7.0 → 0.7.3

package/dist/index.d.ts

@@ -378,11 +378,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 +860,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;
 
@@ -1034,6 +1042,15 @@ export declare interface EntityOption {
     dynasty?: string;
 }
 
+export declare const EntityPage: default_2.FC<EntityPageProps>;
+
+export declare interface EntityPageProps {
+    data: EntityDetailData;
+    transport?: IndexStorage;
+    onNavigate?: (id: string) => void;
+    renderLink?: RenderLink;
+}
+
 export declare const EntityPickerDialog: default_2.FC<EntityPickerDialogProps>;
 
 declare interface EntityPickerDialogProps {
@@ -1281,6 +1298,14 @@ export declare function FilterChip({ label, active, onClick, dashed }: {
     dashed?: boolean;
 }): JSX.Element;
 
+/**
+ * 把 `additional_titles` / `attached_texts` 这类
+ * `(string | { book_title })[]` 摊平成字符串数组。
+ */
+export declare function flattenTitles(items?: (string | {
+    book_title: string;
+})[]): string[];
+
 /**
  * 简单模板替换
  * formatTemplate('共 {n} 册', { n: 100 }) → '共 100 册'
@@ -2475,6 +2500,12 @@ export declare function normalizeCatalog(raw: unknown): VolumeBookMapping;
 
 export declare function normalizeEra(era: string): string;
 
+/**
+ * 把原始 role 歸到粗類。
+ * 空值歸「撰」——802 條 null + 121 條空串，絕大多數是錄入時省略的作者本人著作。
+ */
+export declare function normalizeRole(role?: string | null): RoleClass;
+
 /** volume_index 有 int / number[] / string 三种形态（生产仓实测），统一成 number[] */
 export declare function normalizeVolumeIndex(vi: unknown): number[];
 
@@ -2749,6 +2780,24 @@ export declare type ResourceImportStatus = 'todo' | 'in_progress' | 'done';
 /** 资源导入类型 */
 export declare type ResourceImportType = 'catalog' | 'collection';
 
+/**
+ * 资源行（含分册展开）。
+ *
+ * 三张页面原先各写了一份：作品页 ResourceLine、版本页 BookResourceLine、
+ * 丛编页 CollectionResourceLine —— 名称解析、note 拼接、分册展开按钮、
+ * 缺册划线的样式全都是复制过去的，其中版本页那份连 VolumeLinks 都内联了
+ * 一遍。合成一个，差异用 props 表达。
+ */
+export declare function ResourceLine({ item, siblings, showVolumes, fallbackNote, }: {
+    item: ResourceEntry;
+    /** 同组资源，用于给重名条目加区分后缀（史記在 CText 上三条同名） */
+    siblings?: ResourceEntry[];
+    /** 关掉分册展开：册号已在别处逐个列出时（版本页的「收入叢編」） */
+    showVolumes?: boolean;
+    /** note 为空时的兜底（丛编页用 details 补） */
+    fallbackNote?: string;
+}): JSX.Element;
+
 /**
  * 只读资源列表
  * 用于 kaiyuanguji-web 等场景的资源展示
@@ -2829,6 +2878,34 @@ export declare interface ResourceVolume {
     [key: string]: unknown;
 }
 
+export declare const ROLE_CLASS_ORDER: RoleClass[];
+
+/**
+ * 職任歸一。
+ *
+ * 生產倉全量 62,068 條人物—作品關聯裡出現了 **307 種不同寫法**：
+ * 撰 51,247（82.6%）· 作 2,440 · 編 2,008 · 注 1,003 · 修 927 · 纂修 876 …
+ * 長尾則是「等奉敕撰」「舊題撰」「集解」「校正並音釋」這類，
+ * 還混著繁簡兩寫（輯/辑、註/注、刪/删、傳/传、贊/赞）與私用區壞字。
+ *
+ * 不歸一的話篩選 chips 會炸出上百個按鈕，且「撰」與「等奉敕撰」分屬兩組。
+ * 這裡只歸「篩選用的粗類」，原始寫法仍原樣顯示在「職任」列裡——
+ * 「等奉敕撰」與「撰」的區別對版本學是有意義的，不能真的抹掉。
+ */
+export declare type RoleClass = '撰' | '編' | '注' | '校' | '譯' | '繪' | '其他';
+
+export declare interface RoleFacet {
+    cls: RoleClass | '全部';
+    label: string;
+    count: number;
+}
+
+/** 統計各粗類條數，供篩選 chips 用；空類不出現 */
+export declare function roleFacets(roles: (string | null | undefined)[]): RoleFacet[];
+
+/** 行号：统一补零到两位 */
+export declare function rowNo(i: number): string;
+
 export declare const SearchInput: default_2.FC<SearchInputProps>;
 
 export declare interface SearchInputProps {
@@ -2925,29 +3002,57 @@ export declare interface SyncConfig {
 
 declare type TabKey = 'recommend' | 'catalog' | 'collection' | 'site' | 'feedback';
 
+/** 表头。窄屏由 CSS 隐藏（meta 折到第二行后表头就没意义了）。 */
+export declare function TableHead({ spec }: {
+    spec: TableSpec;
+}): JSX.Element;
+
+/** 表格行：行号 + 主内容 + meta 组合列。宽度取自与表头同一份 spec。 */
+export declare function TableRow({ no, main, meta, spec }: {
+    no: default_2.ReactNode;
+    main: default_2.ReactNode;
+    meta: default_2.ReactNode;
+    spec: TableSpec;
+}): JSX.Element;
+
 /**
- * 表头。columns 描述 meta 区的子列宽度（与行内保持一致）。
- * 窄屏由 CSS 隐藏。
+ * 表格列规格。
+ *
+ * 表头与每一行必须用同一份宽度，否则列会错位。原先三张页面各自把
+ * leadWidth / metaWidth / metaColumns 手抄进 TableHead 和 TableRow 两处
+ * （作品页 22/424、丛编页 26/300、人物页 26/300），改一处忘一处就错位。
+ * 现在一处声明、两处消费。
  */
-export declare function TableHead({ leadWidth, metaWidth, metaColumns, mainLabel }: {
+export declare interface TableSpec {
+    /** 行号列宽 */
     leadWidth: number;
+    /** meta 区总宽 */
     metaWidth: number;
-    metaColumns: {
+    /** meta 区各子列：表头文案 + 宽度 */
+    columns: {
         label: string;
         width: string;
     }[];
+    /** 主列表头文案 */
     mainLabel: string;
-}): JSX.Element;
+}
 
-/** 表格行：行号 + 主内容 + meta 组合列 */
-export declare function TableRow({ no, main, meta, leadWidth, metaWidth, metaColumns }: {
-    no: default_2.ReactNode;
-    main: default_2.ReactNode;
-    meta: default_2.ReactNode;
-    leadWidth: number;
-    metaWidth: number;
-    metaColumns: string[];
-}): JSX.Element;
+/**
+ * 标签 + chip 的一行（别名 / 附载篇目 / 附录）。
+ * 作品页的 TagRows 与版本页的 AliasRow 原是同一段样式的两份拷贝。
+ */
+export declare function TagRow({ label, items }: {
+    label: string;
+    items: string[];
+}): JSX.Element | null;
+
+/** 若干 TagRow 竖排 */
+export declare function TagRows({ rows }: {
+    rows: {
+        label: string;
+        items: string[];
+    }[];
+}): JSX.Element | null;
 
 /** 文字按钮（排序切换等），带下划线 */
 export declare function TextButton({ label, onClick }: {
@@ -3248,6 +3353,11 @@ export declare interface VolumeDetail {
     file?: string;
 }
 
+/** 分册链接网格：缺册划线，无链接的册号显示为灰字 */
+export declare function VolumeLinks({ item }: {
+    item: ResourceEntry;
+}): JSX.Element;
+
 /** 丛编分部 */
 export declare interface VolumeSection {
     name: string;