book-index-ui 0.63.0 → 0.63.2

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
@@ -2263,6 +2263,16 @@ export declare interface EntitySpan {
2263
2263
  targetId?: string;
2264
2264
  /** 条目规范名(卡片标题的后备) */
2265
2265
  canonicalName?: string;
2266
+ /**
2267
+ * 合称(`target.status = "matched_multi"`,book-text#244):一个区间对应两个以上条目(正嘉、二程、六朝)。
2268
+ * 有它时 `targetId` 一定为空——整个区间不是单一链接,悬停/点按出一张列出各条目的卡片。
2269
+ * `part` 是该条目对应区间里的哪段字(可选,按字拆不开的合称不写)。
2270
+ */
2271
+ targets?: Array<{
2272
+ id: string;
2273
+ canonicalName?: string;
2274
+ part?: string;
2275
+ }>;
2266
2276
  /** 置信度 0–1(顶层 `confidence`;缺失时回退用 `target.confidence`) */
2267
2277
  confidence?: number;
2268
2278
  /** `target.confidence`(0–1):对已匹配目标的把握 */
@@ -5456,7 +5466,7 @@ export declare interface ReaderResolveContext {
5456
5466
  /** 字形:原字(不转换,保留异体字)/通行繁体(异体归一)/简体;null = 跟站点繁简 */
5457
5467
  export declare type ReaderScriptMode = ScriptMode;
5458
5468
 
5459
- export declare function ReaderShell({ title, subtitle, toc, activeKey, tocActiveKey, onSelect, tocHeader, tocCaption, images, imagesLoading, renderImageOverlay, imagePanel, prefs, onPrefsChange, paragraphToggle, properNameToggle, allowVertical, origScriptAvailable, byline, current, workLinkToggle, rail, onReportError, revisedAt, backHref, backLabel: backLabelProp, bottomBar, pager, contentLoading, pagerUnit: pagerUnitProp, versions, currentVersionKey, onVersionChange, versionSource, keepChapterOnVersionChange, customImagePanel, toolbarExtra, settingsAnnotate, settingsLayout, isWarpMode, children, className, style, }: ReaderShellProps): JSX.Element;
5469
+ export declare function ReaderShell({ title, subtitle, toc, activeKey, tocActiveKey, onSelect, tocHeader, tocCaption, images, imagesLoading, renderImageOverlay, imagePanel, prefs, onPrefsChange, paragraphToggle, properNameToggle, allowVertical, origScriptAvailable, byline, current, workLinkToggle, rail, onReportError, revisedAt, backHref, backLabel: backLabelProp, bottomBar, pager, contentLoading, pagerUnit: pagerUnitProp, versions, currentVersionKey, onVersionChange, versionSource, keepChapterOnVersionChange, customImagePanel, toolbarExtra, settingsAnnotate, settingsLayout, isWarpMode, showPreserveMargins, children, className, style, }: ReaderShellProps): JSX.Element;
5460
5470
 
5461
5471
  export declare interface ReaderShellProps {
5462
5472
  /** 工具条左侧:书名 */
@@ -5550,6 +5560,8 @@ export declare interface ReaderShellProps {
5550
5560
  settingsLayout?: default_2.ReactNode;
5551
5561
  /** 是否处于 interactive_warp 模式 */
5552
5562
  isWarpMode?: boolean;
5563
+ /** 「书影保留空白」勾选框;图源本身已裁掉空白的书传 false,不显示(默认显示) */
5564
+ showPreserveMargins?: boolean;
5553
5565
  children: default_2.ReactNode;
5554
5566
  className?: string;
5555
5567
  style?: default_2.CSSProperties;
@@ -6825,6 +6837,8 @@ export declare interface TextReaderProps {
6825
6837
  resolveImages?: ReaderImageResolver;
6826
6838
  renderImageOverlay?: ReaderImageOverlay;
6827
6839
  imagePanel?: PanelState;
6840
+ /** 这部书的书影图源已裁去空白(如殿本 qiefen2):不显示「书影保留空白」,书影一律按整图显示 */
6841
+ facsimileTrimmed?: boolean;
6828
6842
  allowVertical?: boolean;
6829
6843
  /** 「报告错字」:回传书名、条目 id、当前章、位置锚点与选中文字,宿主据此打开现有反馈入口(不传则不显示) */
6830
6844
  onReportError?: (ctx: ReaderReportContext) => void;
@@ -6996,8 +7010,10 @@ export declare function useBidUrl(): BidUrlBuilder;
6996
7010
  /**
6997
7011
  * 按当前卷/章向宿主要求透视矫正对读数据;只认最后一次请求的结果。
6998
7012
  * 章元数据里的 has_warp/warp_data(章 json 内联或 URL)已于 2026-10-10 删除,数据与网站都不用;矫正数据只走宿主的 resolve 或 warpDataProp。
7013
+ * 结果记着它属于哪一章(scope+版本+章):换章后新章的数据到手前,warpData 为 null、loading 为真,
7014
+ * 不再把上一章的正文和书影挂在新章上。同一章里宿主重取(resolve 身份变了)不闪。
6999
7015
  */
7000
- export declare function useChapterWarpData(resolve: ReaderWarpResolver | undefined, warpDataProp: PageWarpData | null | undefined, key: string | null, ctx: ReaderResolveContext): {
7016
+ export declare function useChapterWarpData(resolve: ReaderWarpResolver | undefined, warpDataProp: PageWarpData | null | undefined, key: string | null, ctx: ReaderResolveContext, scope?: string): {
7001
7017
  warpData: PageWarpData | null;
7002
7018
  loading: boolean;
7003
7019
  };