@embedpdf/plugin-thumbnail 1.3.3 → 1.3.5

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@embedpdf/core"),e=require("@embedpdf/models"),i="thumbnail",s={id:i,name:"Thumbnail Plugin",version:"1.0.0",provides:["thumbnail"],requires:["render"],optional:[],defaultConfig:{enabled:!0,width:150,gap:10,buffer:3,labelHeight:16}},h=class extends t.BasePlugin{constructor(e,i,s){super(e,i),this.cfg=s,this.thumbs=[],this.window=null,this.emitWindow=t.createBehaviorEmitter(),this.refreshPages$=t.createEmitter(),this.taskCache=new Map,this.renderCapability=this.registry.getPlugin("render").provides(),this.coreStore.onAction(t.SET_DOCUMENT,((t,e)=>{this.taskCache.clear(),this.setWindowState(e)})),this.coreStore.onAction(t.REFRESH_PAGES,(t=>{this.refreshPages$.emit(t.payload);for(const e of t.payload)this.taskCache.delete(e)}))}async initialize(){}onRefreshPages(t){return this.refreshPages$.on(t)}setWindowState(t){const e=t.core;if(!e.document)return;const i=this.cfg.width??120,s=this.cfg.labelHeight??16,h=this.cfg.gap??8;let n=0;this.thumbs=e.document.pages.map((t=>{const e=t.size.height/t.size.width,r=Math.round(i*e),a=r+s,o={pageIndex:t.index,width:i,height:r,wrapperHeight:a,top:n,labelHeight:s};return n+=a+h,o})),this.window={start:-1,end:-1,items:[],totalHeight:n-h},this.emitWindow.emit(this.window)}buildCapability(){return{onWindow:this.emitWindow.on,setViewport:(t,e)=>this.updateWindow(t,e),renderThumb:(t,e)=>this.renderThumb(t,e)}}updateWindow(t,e){const i=this.cfg.buffer??3;let s=0,h=this.thumbs.length-1,n=0;for(;s<=h;){const e=s+h>>1,i=this.thumbs[e];i.top+i.wrapperHeight<t?s=e+1:(n=e,h=e-1)}let r=n;const a=t+e;for(;r+1<this.thumbs.length&&this.thumbs[r].top<a;)r++;r=Math.min(this.thumbs.length-1,r+i);const o=Math.max(0,n-i);this.window&&o===this.window.start&&r===this.window.end||(this.window={start:o,end:r,items:this.thumbs.slice(o,r+1),totalHeight:this.window.totalHeight},this.emitWindow.emit(this.window))}renderThumb(t,i){if(this.taskCache.has(t))return this.taskCache.get(t);const s=this.coreState.core.document.pages[t],h=(this.cfg.width??120)/s.size.width,n=this.renderCapability.renderPageRect({pageIndex:t,rect:{origin:{x:0,y:0},size:s.size},options:{scaleFactor:h,dpr:i}});return this.taskCache.set(t,n),n.wait(e.ignore,(()=>{this.taskCache.delete(t)})),n}};h.id="thumbnail";let n=h;const r={manifest:s,create:(t,e)=>new n(i,t,e),reducer:()=>{},initialState:{}};exports.THUMBNAIL_PLUGIN_ID=i,exports.ThumbnailPlugin=n,exports.ThumbnailPluginPackage=r,exports.manifest=s;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("@embedpdf/core"),i=require("@embedpdf/models"),e="thumbnail",s={id:e,name:"Thumbnail Plugin",version:"1.0.0",provides:["thumbnail"],requires:["render"],optional:["scroll"],defaultConfig:{enabled:!0,width:150,gap:10,buffer:3,labelHeight:16,autoScroll:!0,scrollBehavior:"smooth",imagePadding:0}},o=class extends t.BasePlugin{constructor(i,e,s){var o;super(i,e),this.cfg=s,this.scrollCapability=null,this.thumbs=[],this.window=null,this.viewportH=0,this.scrollY=0,this.emitWindow=t.createBehaviorEmitter(),this.refreshPages$=t.createEmitter(),this.taskCache=new Map,this.canAutoScroll=!0,this.scrollTo$=t.createBehaviorEmitter(),this.renderCapability=this.registry.getPlugin("render").provides(),this.scrollCapability=(null==(o=this.registry.getPlugin("scroll"))?void 0:o.provides())??null,this.coreStore.onAction(t.SET_DOCUMENT,((t,i)=>{this.taskCache.clear(),this.setWindowState(i)})),this.coreStore.onAction(t.REFRESH_PAGES,(t=>{this.refreshPages$.emit(t.payload);for(const i of t.payload)this.taskCache.delete(i)})),this.scrollCapability&&!1!==this.cfg.autoScroll&&(this.scrollCapability.onPageChangeState((({isChanging:t,targetPage:i})=>{this.canAutoScroll=!t,t||this.scrollToThumb(i-1)})),this.scrollCapability.onPageChange((({pageNumber:t})=>{this.canAutoScroll&&this.scrollToThumb(t-1)})))}async initialize(){}onRefreshPages(t){return this.refreshPages$.on(t)}onWindow(t){return this.emitWindow.on(t)}onScrollTo(t){return this.scrollTo$.on(t)}setWindowState(t){const i=t.core;if(!i.document)return;const e=this.cfg.width??120,s=this.cfg.labelHeight??16,o=this.cfg.gap??8,r=this.cfg.imagePadding??0,h=Math.max(1,e-2*r);let a=0;this.thumbs=i.document.pages.map((t=>{const i=t.size.height/t.size.width,e=Math.round(h*i),n=r+e+r+s,l={pageIndex:t.index,width:h,height:e,wrapperHeight:n,top:a,labelHeight:s,padding:r};return a+=n+o,l})),this.window={start:-1,end:-1,items:[],totalHeight:a-o},this.emitWindow.emit(this.window)}buildCapability(){return{renderThumb:(t,i)=>this.renderThumb(t,i),scrollToThumb:t=>this.scrollToThumb(t)}}updateWindow(t,i){const e=this.cfg.buffer??3;this.scrollY=t,this.viewportH=i;let s=0,o=this.thumbs.length-1,r=0;for(;s<=o;){const i=s+o>>1,e=this.thumbs[i];e.top+e.wrapperHeight<t?s=i+1:(r=i,o=i-1)}let h=r;const a=t+i;for(;h+1<this.thumbs.length&&this.thumbs[h].top<a;)h++;h=Math.min(this.thumbs.length-1,h+e);const n=Math.max(0,r-e);this.window&&n===this.window.start&&h===this.window.end||(this.window={start:n,end:h,items:this.thumbs.slice(n,h+1),totalHeight:this.window.totalHeight},this.emitWindow.emit(this.window))}scrollToThumb(t){if(!this.window)return;const i=this.thumbs[t];if(!i)return;const e=this.cfg.scrollBehavior??"smooth";if(this.viewportH<=0){const t=Math.max(0,i.top-i.wrapperHeight);return void this.scrollTo$.emit({top:t,behavior:e})}const s=i.top,o=i.top+i.wrapperHeight,r=s<this.scrollY+8,h=o>this.scrollY+this.viewportH-8;r?this.scrollTo$.emit({top:s,behavior:e}):h&&this.scrollTo$.emit({top:Math.max(0,o-this.viewportH),behavior:e})}renderThumb(t,e){if(this.taskCache.has(t))return this.taskCache.get(t);const s=this.coreState.core.document.pages[t],o=this.cfg.width??120,r=this.cfg.imagePadding??0,h=Math.max(1,o-2*r)/s.size.width,a=this.renderCapability.renderPageRect({pageIndex:t,rect:{origin:{x:0,y:0},size:s.size},options:{scaleFactor:h,dpr:e}});return this.taskCache.set(t,a),a.wait(i.ignore,(()=>this.taskCache.delete(t))),a}};o.id="thumbnail";let r=o;const h={manifest:s,create:(t,i)=>new r(e,t,i),reducer:()=>{},initialState:{}};exports.THUMBNAIL_PLUGIN_ID=e,exports.ThumbnailPlugin=r,exports.ThumbnailPluginPackage=h,exports.manifest=s;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/lib/manifest.ts","../src/lib/thumbnail-plugin.ts","../src/lib/index.ts"],"sourcesContent":["import { PluginManifest } from '@embedpdf/core';\nimport { ThumbnailPluginConfig } from './types';\n\nexport const THUMBNAIL_PLUGIN_ID = 'thumbnail';\n\nexport const manifest: PluginManifest<ThumbnailPluginConfig> = {\n  id: THUMBNAIL_PLUGIN_ID,\n  name: 'Thumbnail Plugin',\n  version: '1.0.0',\n  provides: ['thumbnail'],\n  requires: ['render'],\n  optional: [],\n  defaultConfig: {\n    enabled: true,\n    width: 150,\n    gap: 10,\n    buffer: 3,\n    labelHeight: 16,\n  },\n};\n","import {\n  BasePlugin,\n  CoreState,\n  createBehaviorEmitter,\n  createEmitter,\n  PluginRegistry,\n  REFRESH_PAGES,\n  SET_DOCUMENT,\n  StoreState,\n  Unsubscribe,\n} from '@embedpdf/core';\nimport { ThumbMeta, ThumbnailPluginConfig, WindowState } from './types';\nimport { ThumbnailCapability } from './types';\nimport { ignore, PdfErrorReason, Task } from '@embedpdf/models';\nimport { RenderCapability, RenderPlugin } from '@embedpdf/plugin-render';\n\nexport class ThumbnailPlugin extends BasePlugin<ThumbnailPluginConfig, ThumbnailCapability> {\n  static readonly id = 'thumbnail' as const;\n\n  private renderCapability: RenderCapability;\n  private thumbs: ThumbMeta[] = [];\n  private window: WindowState | null = null;\n  private readonly emitWindow = createBehaviorEmitter<WindowState>();\n  private readonly refreshPages$ = createEmitter<number[]>();\n  private readonly taskCache = new Map<number, Task<Blob, PdfErrorReason>>();\n\n  constructor(\n    id: string,\n    registry: PluginRegistry,\n    private cfg: ThumbnailPluginConfig,\n  ) {\n    super(id, registry);\n\n    this.renderCapability = this.registry.getPlugin<RenderPlugin>('render')!.provides();\n\n    this.coreStore.onAction(SET_DOCUMENT, (_action, state) => {\n      this.taskCache.clear();\n      this.setWindowState(state);\n    });\n\n    this.coreStore.onAction(REFRESH_PAGES, (action) => {\n      this.refreshPages$.emit(action.payload);\n      for (const pageIdx of action.payload) {\n        this.taskCache.delete(pageIdx);\n      }\n    });\n  }\n\n  /* ------------ init ------------------------------------------------ */\n  async initialize(): Promise<void> {}\n\n  public onRefreshPages(fn: (pages: number[]) => void): Unsubscribe {\n    return this.refreshPages$.on(fn);\n  }\n\n  private setWindowState(state: StoreState<CoreState>) {\n    const core = state.core;\n\n    if (!core.document) return;\n\n    const W = this.cfg.width ?? 120;\n    const L = this.cfg.labelHeight ?? 16; // label\n    const GAP = this.cfg.gap ?? 8;\n\n    let offset = 0;\n    this.thumbs = core.document.pages.map((p) => {\n      const ratio = p.size.height / p.size.width;\n      const thumbH = Math.round(W * ratio);\n      const wrapH = thumbH + L; // no GAP here\n\n      const meta: ThumbMeta = {\n        pageIndex: p.index,\n        width: W,\n        height: thumbH,\n        wrapperHeight: wrapH,\n        top: offset,\n        labelHeight: L,\n      };\n      offset += wrapH + GAP; // GAP added *after* wrapper\n      return meta;\n    });\n\n    this.window = {\n      start: -1,\n      end: -1,\n      items: [],\n      totalHeight: offset - GAP, // last item has no gap below\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ capability ----------------------------------------- */\n  protected buildCapability(): ThumbnailCapability {\n    return {\n      onWindow: this.emitWindow.on,\n      setViewport: (y, h) => this.updateWindow(y, h),\n      renderThumb: (idx, dpr) => this.renderThumb(idx, dpr),\n    };\n  }\n\n  /* ------------ windowing math ------------------------------------- */\n  private updateWindow(scrollY: number, viewportH: number) {\n    const BUF = this.cfg.buffer ?? 3;\n\n    /* -------- find first visible wrapper ---------- */\n    let low = 0,\n      high = this.thumbs.length - 1,\n      first = 0;\n    while (low <= high) {\n      const mid = (low + high) >> 1;\n      const m = this.thumbs[mid];\n      if (m.top + m.wrapperHeight < scrollY) low = mid + 1;\n      else {\n        first = mid;\n        high = mid - 1;\n      }\n    }\n\n    /* -------- find last visible + buffer ---------- */\n    let last = first;\n    const limit = scrollY + viewportH;\n    while (last + 1 < this.thumbs.length && this.thumbs[last].top < limit) last++;\n    last = Math.min(this.thumbs.length - 1, last + BUF);\n\n    const start = Math.max(0, first - BUF);\n    if (this.window && start === this.window.start && last === this.window.end) return;\n\n    this.window = {\n      start,\n      end: last,\n      items: this.thumbs.slice(start, last + 1),\n      totalHeight: this.window!.totalHeight,\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ thumbnail raster ----------------------------------- */\n  private renderThumb(idx: number, dpr: number) {\n    if (this.taskCache.has(idx)) return this.taskCache.get(idx)!;\n\n    const core = this.coreState.core;\n    const page = core.document!.pages[idx];\n    const scale = (this.cfg.width ?? 120) / page.size.width;\n\n    const task = this.renderCapability.renderPageRect({\n      pageIndex: idx,\n      rect: { origin: { x: 0, y: 0 }, size: page.size },\n      options: {\n        scaleFactor: scale,\n        dpr,\n      },\n    });\n\n    this.taskCache.set(idx, task);\n\n    task.wait(ignore, () => {\n      this.taskCache.delete(idx);\n    });\n\n    return task;\n  }\n}\n","import { PluginPackage } from '@embedpdf/core';\nimport { manifest, THUMBNAIL_PLUGIN_ID } from './manifest';\nimport { ThumbnailPluginConfig } from './types';\nimport { ThumbnailPlugin } from './thumbnail-plugin';\n\nexport const ThumbnailPluginPackage: PluginPackage<ThumbnailPlugin, ThumbnailPluginConfig> = {\n  manifest,\n  create: (registry, config) => new ThumbnailPlugin(THUMBNAIL_PLUGIN_ID, registry, config),\n  reducer: () => {},\n  initialState: {},\n};\n\nexport * from './thumbnail-plugin';\nexport * from './types';\nexport * from './manifest';\n"],"names":["THUMBNAIL_PLUGIN_ID","manifest","id","name","version","provides","requires","optional","defaultConfig","enabled","width","gap","buffer","labelHeight","_ThumbnailPlugin","BasePlugin","constructor","registry","cfg","super","this","thumbs","window","emitWindow","createBehaviorEmitter","refreshPages$","createEmitter","taskCache","Map","renderCapability","getPlugin","coreStore","onAction","SET_DOCUMENT","_action","state","clear","setWindowState","REFRESH_PAGES","action","emit","payload","pageIdx","delete","initialize","onRefreshPages","fn","on","core","document","W","L","GAP","offset","pages","map","p","ratio","size","height","thumbH","Math","round","wrapH","meta","pageIndex","index","wrapperHeight","top","start","end","items","totalHeight","buildCapability","onWindow","setViewport","y","h","updateWindow","renderThumb","idx","dpr","scrollY","viewportH","BUF","low","high","length","first","mid","m","last","limit","min","max","slice","has","get","page","coreState","scale","task","renderPageRect","rect","origin","x","options","scaleFactor","set","wait","ignore","ThumbnailPlugin","ThumbnailPluginPackage","create","config","reducer","initialState"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/lib/manifest.ts","../src/lib/thumbnail-plugin.ts","../src/lib/index.ts"],"sourcesContent":["import { PluginManifest } from '@embedpdf/core';\nimport { ThumbnailPluginConfig } from './types';\n\nexport const THUMBNAIL_PLUGIN_ID = 'thumbnail';\n\nexport const manifest: PluginManifest<ThumbnailPluginConfig> = {\n  id: THUMBNAIL_PLUGIN_ID,\n  name: 'Thumbnail Plugin',\n  version: '1.0.0',\n  provides: ['thumbnail'],\n  requires: ['render'],\n  optional: ['scroll'],\n  defaultConfig: {\n    enabled: true,\n    width: 150,\n    gap: 10,\n    buffer: 3,\n    labelHeight: 16,\n    autoScroll: true,\n    scrollBehavior: 'smooth',\n    imagePadding: 0,\n  },\n};\n","import {\n  BasePlugin,\n  CoreState,\n  createBehaviorEmitter,\n  createEmitter,\n  PluginRegistry,\n  REFRESH_PAGES,\n  SET_DOCUMENT,\n  StoreState,\n  Unsubscribe,\n} from '@embedpdf/core';\nimport { ScrollToOptions, ThumbMeta, ThumbnailPluginConfig, WindowState } from './types';\nimport { ThumbnailCapability } from './types';\nimport { ignore, PdfErrorReason, Task } from '@embedpdf/models';\nimport { RenderCapability, RenderPlugin } from '@embedpdf/plugin-render';\nimport { ScrollCapability, ScrollPlugin } from '@embedpdf/plugin-scroll';\n\nexport class ThumbnailPlugin extends BasePlugin<ThumbnailPluginConfig, ThumbnailCapability> {\n  static readonly id = 'thumbnail' as const;\n\n  private renderCapability: RenderCapability;\n  private scrollCapability: ScrollCapability | null = null;\n  private thumbs: ThumbMeta[] = [];\n  private window: WindowState | null = null;\n\n  // track viewport metrics for scroll decisions\n  private viewportH: number = 0;\n  private scrollY: number = 0;\n\n  private readonly emitWindow = createBehaviorEmitter<WindowState>();\n  private readonly refreshPages$ = createEmitter<number[]>();\n  private readonly taskCache = new Map<number, Task<Blob, PdfErrorReason>>();\n  private canAutoScroll = true;\n  // ask pane to scroll to a specific top\n  private readonly scrollTo$ = createBehaviorEmitter<ScrollToOptions>();\n\n  constructor(\n    id: string,\n    registry: PluginRegistry,\n    private cfg: ThumbnailPluginConfig,\n  ) {\n    super(id, registry);\n\n    this.renderCapability = this.registry.getPlugin<RenderPlugin>('render')!.provides();\n    this.scrollCapability = this.registry.getPlugin<ScrollPlugin>('scroll')?.provides() ?? null;\n\n    this.coreStore.onAction(SET_DOCUMENT, (_action, state) => {\n      this.taskCache.clear();\n      this.setWindowState(state);\n    });\n\n    this.coreStore.onAction(REFRESH_PAGES, (action) => {\n      this.refreshPages$.emit(action.payload);\n      for (const pageIdx of action.payload) {\n        this.taskCache.delete(pageIdx);\n      }\n    });\n\n    // auto-scroll thumbnails when the main scroller's current page changes\n    if (this.scrollCapability && this.cfg.autoScroll !== false) {\n      this.scrollCapability.onPageChangeState(({ isChanging, targetPage }) => {\n        this.canAutoScroll = !isChanging;\n        if (!isChanging) {\n          this.scrollToThumb(targetPage - 1);\n        }\n      });\n      this.scrollCapability.onPageChange(({ pageNumber }) => {\n        if (this.canAutoScroll) {\n          this.scrollToThumb(pageNumber - 1);\n        }\n      });\n    }\n  }\n\n  /* ------------ init ------------------------------------------------ */\n  async initialize(): Promise<void> {}\n\n  public onRefreshPages(fn: (pages: number[]) => void): Unsubscribe {\n    return this.refreshPages$.on(fn);\n  }\n\n  public onWindow(cb: (w: WindowState) => void): Unsubscribe {\n    return this.emitWindow.on(cb);\n  }\n\n  public onScrollTo(cb: (o: ScrollToOptions) => void): Unsubscribe {\n    return this.scrollTo$.on(cb);\n  }\n\n  private setWindowState(state: StoreState<CoreState>) {\n    const core = state.core;\n    if (!core.document) return;\n\n    const OUTER_W = this.cfg.width ?? 120;\n    const L = this.cfg.labelHeight ?? 16;\n    const GAP = this.cfg.gap ?? 8;\n    const P = this.cfg.imagePadding ?? 0;\n\n    // Inner bitmap width cannot go below 1px\n    const INNER_W = Math.max(1, OUTER_W - 2 * P);\n\n    let offset = 0;\n    this.thumbs = core.document.pages.map((p) => {\n      const ratio = p.size.height / p.size.width;\n      const imgH = Math.round(INNER_W * ratio);\n      const wrapH = P + imgH + P + L; // padding + image + padding + label\n\n      const meta: ThumbMeta = {\n        pageIndex: p.index,\n        width: INNER_W, // bitmap width (for <img> size)\n        height: imgH, // bitmap height (for <img> size)\n        wrapperHeight: wrapH, // full row height used by virtualizer\n        top: offset, // top of the row\n        labelHeight: L,\n        padding: P, // NEW\n      };\n      offset += wrapH + GAP;\n      return meta;\n    });\n\n    this.window = {\n      start: -1,\n      end: -1,\n      items: [],\n      totalHeight: offset - GAP,\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ capability ----------------------------------------- */\n  protected buildCapability(): ThumbnailCapability {\n    return {\n      renderThumb: (idx, dpr) => this.renderThumb(idx, dpr),\n      scrollToThumb: (pageIdx) => this.scrollToThumb(pageIdx),\n    };\n  }\n\n  /* ------------ windowing & viewport state ------------------------- */\n  public updateWindow(scrollY: number, viewportH: number) {\n    const BUF = this.cfg.buffer ?? 3;\n\n    // remember latest viewport metrics for scroll decisions\n    this.scrollY = scrollY;\n    this.viewportH = viewportH;\n\n    /* find first visible */\n    let low = 0,\n      high = this.thumbs.length - 1,\n      first = 0;\n    while (low <= high) {\n      const mid = (low + high) >> 1;\n      const m = this.thumbs[mid];\n      if (m.top + m.wrapperHeight < scrollY) low = mid + 1;\n      else {\n        first = mid;\n        high = mid - 1;\n      }\n    }\n\n    /* find last visible + buffer */\n    let last = first;\n    const limit = scrollY + viewportH;\n    while (last + 1 < this.thumbs.length && this.thumbs[last].top < limit) last++;\n    last = Math.min(this.thumbs.length - 1, last + BUF);\n\n    const start = Math.max(0, first - BUF);\n    if (this.window && start === this.window.start && last === this.window.end) return;\n\n    this.window = {\n      start,\n      end: last,\n      items: this.thumbs.slice(start, last + 1),\n      totalHeight: this.window!.totalHeight,\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ scroll helper now in plugin ------------------------ */\n  private scrollToThumb(pageIdx: number) {\n    if (!this.window) return;\n    const item = this.thumbs[pageIdx];\n    if (!item) return;\n\n    const behavior = this.cfg.scrollBehavior ?? 'smooth';\n\n    if (this.viewportH <= 0) {\n      // Center the thumbnail in the viewport\n      const top = Math.max(0, item.top - item.wrapperHeight);\n      this.scrollTo$.emit({ top, behavior });\n      return;\n    }\n\n    const margin = 8;\n    const top = item.top;\n    const bottom = item.top + item.wrapperHeight;\n\n    const needsUp = top < this.scrollY + margin;\n    const needsDown = bottom > this.scrollY + this.viewportH - margin;\n\n    if (needsUp) {\n      this.scrollTo$.emit({ top, behavior });\n    } else if (needsDown) {\n      this.scrollTo$.emit({ top: Math.max(0, bottom - this.viewportH), behavior });\n    }\n  }\n\n  /* ------------ thumbnail raster ----------------------------------- */\n  private renderThumb(idx: number, dpr: number) {\n    if (this.taskCache.has(idx)) return this.taskCache.get(idx)!;\n\n    const core = this.coreState.core;\n    const page = core.document!.pages[idx];\n\n    const OUTER_W = this.cfg.width ?? 120;\n    const P = this.cfg.imagePadding ?? 0;\n    const INNER_W = Math.max(1, OUTER_W - 2 * P);\n\n    const scale = INNER_W / page.size.width; // scale to inner width (excludes padding)\n\n    const task = this.renderCapability.renderPageRect({\n      pageIndex: idx,\n      rect: { origin: { x: 0, y: 0 }, size: page.size },\n      options: {\n        scaleFactor: scale,\n        dpr,\n      },\n    });\n\n    this.taskCache.set(idx, task);\n    task.wait(ignore, () => this.taskCache.delete(idx));\n    return task;\n  }\n}\n","import { PluginPackage } from '@embedpdf/core';\nimport { manifest, THUMBNAIL_PLUGIN_ID } from './manifest';\nimport { ThumbnailPluginConfig } from './types';\nimport { ThumbnailPlugin } from './thumbnail-plugin';\n\nexport const ThumbnailPluginPackage: PluginPackage<ThumbnailPlugin, ThumbnailPluginConfig> = {\n  manifest,\n  create: (registry, config) => new ThumbnailPlugin(THUMBNAIL_PLUGIN_ID, registry, config),\n  reducer: () => {},\n  initialState: {},\n};\n\nexport * from './thumbnail-plugin';\nexport * from './types';\nexport * from './manifest';\n"],"names":["THUMBNAIL_PLUGIN_ID","manifest","id","name","version","provides","requires","optional","defaultConfig","enabled","width","gap","buffer","labelHeight","autoScroll","scrollBehavior","imagePadding","_ThumbnailPlugin","BasePlugin","constructor","registry","cfg","super","this","scrollCapability","thumbs","window","viewportH","scrollY","emitWindow","createBehaviorEmitter","refreshPages$","createEmitter","taskCache","Map","canAutoScroll","scrollTo$","renderCapability","getPlugin","_a","coreStore","onAction","SET_DOCUMENT","_action","state","clear","setWindowState","REFRESH_PAGES","action","emit","payload","pageIdx","delete","onPageChangeState","isChanging","targetPage","scrollToThumb","onPageChange","pageNumber","initialize","onRefreshPages","fn","on","onWindow","cb","onScrollTo","core","document","OUTER_W","L","GAP","P","INNER_W","Math","max","offset","pages","map","p","ratio","size","height","imgH","round","wrapH","meta","pageIndex","index","wrapperHeight","top","padding","start","end","items","totalHeight","buildCapability","renderThumb","idx","dpr","updateWindow","BUF","low","high","length","first","mid","m","last","limit","min","slice","item","behavior","bottom","needsUp","needsDown","has","get","page","coreState","scale","task","renderPageRect","rect","origin","x","y","options","scaleFactor","set","wait","ignore","ThumbnailPlugin","ThumbnailPluginPackage","create","config","reducer","initialState"],"mappings":"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"}

package/dist/index.js

@@ -7,25 +7,35 @@ const manifest = {
   version: "1.0.0",
   provides: ["thumbnail"],
   requires: ["render"],
-  optional: [],
+  optional: ["scroll"],
   defaultConfig: {
     enabled: true,
     width: 150,
     gap: 10,
     buffer: 3,
-    labelHeight: 16
+    labelHeight: 16,
+    autoScroll: true,
+    scrollBehavior: "smooth",
+    imagePadding: 0
   }
 };
 const _ThumbnailPlugin = class _ThumbnailPlugin extends BasePlugin {
   constructor(id, registry, cfg) {
+    var _a;
     super(id, registry);
     this.cfg = cfg;
+    this.scrollCapability = null;
     this.thumbs = [];
     this.window = null;
+    this.viewportH = 0;
+    this.scrollY = 0;
     this.emitWindow = createBehaviorEmitter();
     this.refreshPages$ = createEmitter();
     this.taskCache = /* @__PURE__ */ new Map();
+    this.canAutoScroll = true;
+    this.scrollTo$ = createBehaviorEmitter();
     this.renderCapability = this.registry.getPlugin("render").provides();
+    this.scrollCapability = ((_a = this.registry.getPlugin("scroll")) == null ? void 0 : _a.provides()) ?? null;
     this.coreStore.onAction(SET_DOCUMENT, (_action, state) => {
       this.taskCache.clear();
       this.setWindowState(state);
@@ -36,6 +46,19 @@ const _ThumbnailPlugin = class _ThumbnailPlugin extends BasePlugin {
         this.taskCache.delete(pageIdx);
       }
     });
+    if (this.scrollCapability && this.cfg.autoScroll !== false) {
+      this.scrollCapability.onPageChangeState(({ isChanging, targetPage }) => {
+        this.canAutoScroll = !isChanging;
+        if (!isChanging) {
+          this.scrollToThumb(targetPage - 1);
+        }
+      });
+      this.scrollCapability.onPageChange(({ pageNumber }) => {
+        if (this.canAutoScroll) {
+          this.scrollToThumb(pageNumber - 1);
+        }
+      });
+    }
   }
   /* ------------ init ------------------------------------------------ */
   async initialize() {
@@ -43,24 +66,38 @@ const _ThumbnailPlugin = class _ThumbnailPlugin extends BasePlugin {
   onRefreshPages(fn) {
     return this.refreshPages$.on(fn);
   }
+  onWindow(cb) {
+    return this.emitWindow.on(cb);
+  }
+  onScrollTo(cb) {
+    return this.scrollTo$.on(cb);
+  }
   setWindowState(state) {
     const core = state.core;
     if (!core.document) return;
-    const W = this.cfg.width ?? 120;
+    const OUTER_W = this.cfg.width ?? 120;
     const L = this.cfg.labelHeight ?? 16;
     const GAP = this.cfg.gap ?? 8;
+    const P = this.cfg.imagePadding ?? 0;
+    const INNER_W = Math.max(1, OUTER_W - 2 * P);
     let offset = 0;
     this.thumbs = core.document.pages.map((p) => {
       const ratio = p.size.height / p.size.width;
-      const thumbH = Math.round(W * ratio);
-      const wrapH = thumbH + L;
+      const imgH = Math.round(INNER_W * ratio);
+      const wrapH = P + imgH + P + L;
       const meta = {
         pageIndex: p.index,
-        width: W,
-        height: thumbH,
+        width: INNER_W,
+        // bitmap width (for <img> size)
+        height: imgH,
+        // bitmap height (for <img> size)
         wrapperHeight: wrapH,
+        // full row height used by virtualizer
         top: offset,
-        labelHeight: L
+        // top of the row
+        labelHeight: L,
+        padding: P
+        // NEW
       };
       offset += wrapH + GAP;
       return meta;
@@ -70,21 +107,21 @@ const _ThumbnailPlugin = class _ThumbnailPlugin extends BasePlugin {
       end: -1,
       items: [],
       totalHeight: offset - GAP
-      // last item has no gap below
     };
     this.emitWindow.emit(this.window);
   }
   /* ------------ capability ----------------------------------------- */
   buildCapability() {
     return {
-      onWindow: this.emitWindow.on,
-      setViewport: (y, h) => this.updateWindow(y, h),
-      renderThumb: (idx, dpr) => this.renderThumb(idx, dpr)
+      renderThumb: (idx, dpr) => this.renderThumb(idx, dpr),
+      scrollToThumb: (pageIdx) => this.scrollToThumb(pageIdx)
     };
   }
-  /* ------------ windowing math ------------------------------------- */
+  /* ------------ windowing & viewport state ------------------------- */
   updateWindow(scrollY, viewportH) {
     const BUF = this.cfg.buffer ?? 3;
+    this.scrollY = scrollY;
+    this.viewportH = viewportH;
     let low = 0, high = this.thumbs.length - 1, first = 0;
     while (low <= high) {
       const mid = low + high >> 1;
@@ -109,12 +146,37 @@ const _ThumbnailPlugin = class _ThumbnailPlugin extends BasePlugin {
     };
     this.emitWindow.emit(this.window);
   }
+  /* ------------ scroll helper now in plugin ------------------------ */
+  scrollToThumb(pageIdx) {
+    if (!this.window) return;
+    const item = this.thumbs[pageIdx];
+    if (!item) return;
+    const behavior = this.cfg.scrollBehavior ?? "smooth";
+    if (this.viewportH <= 0) {
+      const top2 = Math.max(0, item.top - item.wrapperHeight);
+      this.scrollTo$.emit({ top: top2, behavior });
+      return;
+    }
+    const margin = 8;
+    const top = item.top;
+    const bottom = item.top + item.wrapperHeight;
+    const needsUp = top < this.scrollY + margin;
+    const needsDown = bottom > this.scrollY + this.viewportH - margin;
+    if (needsUp) {
+      this.scrollTo$.emit({ top, behavior });
+    } else if (needsDown) {
+      this.scrollTo$.emit({ top: Math.max(0, bottom - this.viewportH), behavior });
+    }
+  }
   /* ------------ thumbnail raster ----------------------------------- */
   renderThumb(idx, dpr) {
     if (this.taskCache.has(idx)) return this.taskCache.get(idx);
     const core = this.coreState.core;
     const page = core.document.pages[idx];
-    const scale = (this.cfg.width ?? 120) / page.size.width;
+    const OUTER_W = this.cfg.width ?? 120;
+    const P = this.cfg.imagePadding ?? 0;
+    const INNER_W = Math.max(1, OUTER_W - 2 * P);
+    const scale = INNER_W / page.size.width;
     const task = this.renderCapability.renderPageRect({
       pageIndex: idx,
       rect: { origin: { x: 0, y: 0 }, size: page.size },
@@ -124,9 +186,7 @@ const _ThumbnailPlugin = class _ThumbnailPlugin extends BasePlugin {
       }
     });
     this.taskCache.set(idx, task);
-    task.wait(ignore, () => {
-      this.taskCache.delete(idx);
-    });
+    task.wait(ignore, () => this.taskCache.delete(idx));
     return task;
   }
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/lib/manifest.ts","../src/lib/thumbnail-plugin.ts","../src/lib/index.ts"],"sourcesContent":["import { PluginManifest } from '@embedpdf/core';\nimport { ThumbnailPluginConfig } from './types';\n\nexport const THUMBNAIL_PLUGIN_ID = 'thumbnail';\n\nexport const manifest: PluginManifest<ThumbnailPluginConfig> = {\n  id: THUMBNAIL_PLUGIN_ID,\n  name: 'Thumbnail Plugin',\n  version: '1.0.0',\n  provides: ['thumbnail'],\n  requires: ['render'],\n  optional: [],\n  defaultConfig: {\n    enabled: true,\n    width: 150,\n    gap: 10,\n    buffer: 3,\n    labelHeight: 16,\n  },\n};\n","import {\n  BasePlugin,\n  CoreState,\n  createBehaviorEmitter,\n  createEmitter,\n  PluginRegistry,\n  REFRESH_PAGES,\n  SET_DOCUMENT,\n  StoreState,\n  Unsubscribe,\n} from '@embedpdf/core';\nimport { ThumbMeta, ThumbnailPluginConfig, WindowState } from './types';\nimport { ThumbnailCapability } from './types';\nimport { ignore, PdfErrorReason, Task } from '@embedpdf/models';\nimport { RenderCapability, RenderPlugin } from '@embedpdf/plugin-render';\n\nexport class ThumbnailPlugin extends BasePlugin<ThumbnailPluginConfig, ThumbnailCapability> {\n  static readonly id = 'thumbnail' as const;\n\n  private renderCapability: RenderCapability;\n  private thumbs: ThumbMeta[] = [];\n  private window: WindowState | null = null;\n  private readonly emitWindow = createBehaviorEmitter<WindowState>();\n  private readonly refreshPages$ = createEmitter<number[]>();\n  private readonly taskCache = new Map<number, Task<Blob, PdfErrorReason>>();\n\n  constructor(\n    id: string,\n    registry: PluginRegistry,\n    private cfg: ThumbnailPluginConfig,\n  ) {\n    super(id, registry);\n\n    this.renderCapability = this.registry.getPlugin<RenderPlugin>('render')!.provides();\n\n    this.coreStore.onAction(SET_DOCUMENT, (_action, state) => {\n      this.taskCache.clear();\n      this.setWindowState(state);\n    });\n\n    this.coreStore.onAction(REFRESH_PAGES, (action) => {\n      this.refreshPages$.emit(action.payload);\n      for (const pageIdx of action.payload) {\n        this.taskCache.delete(pageIdx);\n      }\n    });\n  }\n\n  /* ------------ init ------------------------------------------------ */\n  async initialize(): Promise<void> {}\n\n  public onRefreshPages(fn: (pages: number[]) => void): Unsubscribe {\n    return this.refreshPages$.on(fn);\n  }\n\n  private setWindowState(state: StoreState<CoreState>) {\n    const core = state.core;\n\n    if (!core.document) return;\n\n    const W = this.cfg.width ?? 120;\n    const L = this.cfg.labelHeight ?? 16; // label\n    const GAP = this.cfg.gap ?? 8;\n\n    let offset = 0;\n    this.thumbs = core.document.pages.map((p) => {\n      const ratio = p.size.height / p.size.width;\n      const thumbH = Math.round(W * ratio);\n      const wrapH = thumbH + L; // no GAP here\n\n      const meta: ThumbMeta = {\n        pageIndex: p.index,\n        width: W,\n        height: thumbH,\n        wrapperHeight: wrapH,\n        top: offset,\n        labelHeight: L,\n      };\n      offset += wrapH + GAP; // GAP added *after* wrapper\n      return meta;\n    });\n\n    this.window = {\n      start: -1,\n      end: -1,\n      items: [],\n      totalHeight: offset - GAP, // last item has no gap below\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ capability ----------------------------------------- */\n  protected buildCapability(): ThumbnailCapability {\n    return {\n      onWindow: this.emitWindow.on,\n      setViewport: (y, h) => this.updateWindow(y, h),\n      renderThumb: (idx, dpr) => this.renderThumb(idx, dpr),\n    };\n  }\n\n  /* ------------ windowing math ------------------------------------- */\n  private updateWindow(scrollY: number, viewportH: number) {\n    const BUF = this.cfg.buffer ?? 3;\n\n    /* -------- find first visible wrapper ---------- */\n    let low = 0,\n      high = this.thumbs.length - 1,\n      first = 0;\n    while (low <= high) {\n      const mid = (low + high) >> 1;\n      const m = this.thumbs[mid];\n      if (m.top + m.wrapperHeight < scrollY) low = mid + 1;\n      else {\n        first = mid;\n        high = mid - 1;\n      }\n    }\n\n    /* -------- find last visible + buffer ---------- */\n    let last = first;\n    const limit = scrollY + viewportH;\n    while (last + 1 < this.thumbs.length && this.thumbs[last].top < limit) last++;\n    last = Math.min(this.thumbs.length - 1, last + BUF);\n\n    const start = Math.max(0, first - BUF);\n    if (this.window && start === this.window.start && last === this.window.end) return;\n\n    this.window = {\n      start,\n      end: last,\n      items: this.thumbs.slice(start, last + 1),\n      totalHeight: this.window!.totalHeight,\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ thumbnail raster ----------------------------------- */\n  private renderThumb(idx: number, dpr: number) {\n    if (this.taskCache.has(idx)) return this.taskCache.get(idx)!;\n\n    const core = this.coreState.core;\n    const page = core.document!.pages[idx];\n    const scale = (this.cfg.width ?? 120) / page.size.width;\n\n    const task = this.renderCapability.renderPageRect({\n      pageIndex: idx,\n      rect: { origin: { x: 0, y: 0 }, size: page.size },\n      options: {\n        scaleFactor: scale,\n        dpr,\n      },\n    });\n\n    this.taskCache.set(idx, task);\n\n    task.wait(ignore, () => {\n      this.taskCache.delete(idx);\n    });\n\n    return task;\n  }\n}\n","import { PluginPackage } from '@embedpdf/core';\nimport { manifest, THUMBNAIL_PLUGIN_ID } from './manifest';\nimport { ThumbnailPluginConfig } from './types';\nimport { ThumbnailPlugin } from './thumbnail-plugin';\n\nexport const ThumbnailPluginPackage: PluginPackage<ThumbnailPlugin, ThumbnailPluginConfig> = {\n  manifest,\n  create: (registry, config) => new ThumbnailPlugin(THUMBNAIL_PLUGIN_ID, registry, config),\n  reducer: () => {},\n  initialState: {},\n};\n\nexport * from './thumbnail-plugin';\nexport * from './types';\nexport * from './manifest';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/lib/manifest.ts","../src/lib/thumbnail-plugin.ts","../src/lib/index.ts"],"sourcesContent":["import { PluginManifest } from '@embedpdf/core';\nimport { ThumbnailPluginConfig } from './types';\n\nexport const THUMBNAIL_PLUGIN_ID = 'thumbnail';\n\nexport const manifest: PluginManifest<ThumbnailPluginConfig> = {\n  id: THUMBNAIL_PLUGIN_ID,\n  name: 'Thumbnail Plugin',\n  version: '1.0.0',\n  provides: ['thumbnail'],\n  requires: ['render'],\n  optional: ['scroll'],\n  defaultConfig: {\n    enabled: true,\n    width: 150,\n    gap: 10,\n    buffer: 3,\n    labelHeight: 16,\n    autoScroll: true,\n    scrollBehavior: 'smooth',\n    imagePadding: 0,\n  },\n};\n","import {\n  BasePlugin,\n  CoreState,\n  createBehaviorEmitter,\n  createEmitter,\n  PluginRegistry,\n  REFRESH_PAGES,\n  SET_DOCUMENT,\n  StoreState,\n  Unsubscribe,\n} from '@embedpdf/core';\nimport { ScrollToOptions, ThumbMeta, ThumbnailPluginConfig, WindowState } from './types';\nimport { ThumbnailCapability } from './types';\nimport { ignore, PdfErrorReason, Task } from '@embedpdf/models';\nimport { RenderCapability, RenderPlugin } from '@embedpdf/plugin-render';\nimport { ScrollCapability, ScrollPlugin } from '@embedpdf/plugin-scroll';\n\nexport class ThumbnailPlugin extends BasePlugin<ThumbnailPluginConfig, ThumbnailCapability> {\n  static readonly id = 'thumbnail' as const;\n\n  private renderCapability: RenderCapability;\n  private scrollCapability: ScrollCapability | null = null;\n  private thumbs: ThumbMeta[] = [];\n  private window: WindowState | null = null;\n\n  // track viewport metrics for scroll decisions\n  private viewportH: number = 0;\n  private scrollY: number = 0;\n\n  private readonly emitWindow = createBehaviorEmitter<WindowState>();\n  private readonly refreshPages$ = createEmitter<number[]>();\n  private readonly taskCache = new Map<number, Task<Blob, PdfErrorReason>>();\n  private canAutoScroll = true;\n  // ask pane to scroll to a specific top\n  private readonly scrollTo$ = createBehaviorEmitter<ScrollToOptions>();\n\n  constructor(\n    id: string,\n    registry: PluginRegistry,\n    private cfg: ThumbnailPluginConfig,\n  ) {\n    super(id, registry);\n\n    this.renderCapability = this.registry.getPlugin<RenderPlugin>('render')!.provides();\n    this.scrollCapability = this.registry.getPlugin<ScrollPlugin>('scroll')?.provides() ?? null;\n\n    this.coreStore.onAction(SET_DOCUMENT, (_action, state) => {\n      this.taskCache.clear();\n      this.setWindowState(state);\n    });\n\n    this.coreStore.onAction(REFRESH_PAGES, (action) => {\n      this.refreshPages$.emit(action.payload);\n      for (const pageIdx of action.payload) {\n        this.taskCache.delete(pageIdx);\n      }\n    });\n\n    // auto-scroll thumbnails when the main scroller's current page changes\n    if (this.scrollCapability && this.cfg.autoScroll !== false) {\n      this.scrollCapability.onPageChangeState(({ isChanging, targetPage }) => {\n        this.canAutoScroll = !isChanging;\n        if (!isChanging) {\n          this.scrollToThumb(targetPage - 1);\n        }\n      });\n      this.scrollCapability.onPageChange(({ pageNumber }) => {\n        if (this.canAutoScroll) {\n          this.scrollToThumb(pageNumber - 1);\n        }\n      });\n    }\n  }\n\n  /* ------------ init ------------------------------------------------ */\n  async initialize(): Promise<void> {}\n\n  public onRefreshPages(fn: (pages: number[]) => void): Unsubscribe {\n    return this.refreshPages$.on(fn);\n  }\n\n  public onWindow(cb: (w: WindowState) => void): Unsubscribe {\n    return this.emitWindow.on(cb);\n  }\n\n  public onScrollTo(cb: (o: ScrollToOptions) => void): Unsubscribe {\n    return this.scrollTo$.on(cb);\n  }\n\n  private setWindowState(state: StoreState<CoreState>) {\n    const core = state.core;\n    if (!core.document) return;\n\n    const OUTER_W = this.cfg.width ?? 120;\n    const L = this.cfg.labelHeight ?? 16;\n    const GAP = this.cfg.gap ?? 8;\n    const P = this.cfg.imagePadding ?? 0;\n\n    // Inner bitmap width cannot go below 1px\n    const INNER_W = Math.max(1, OUTER_W - 2 * P);\n\n    let offset = 0;\n    this.thumbs = core.document.pages.map((p) => {\n      const ratio = p.size.height / p.size.width;\n      const imgH = Math.round(INNER_W * ratio);\n      const wrapH = P + imgH + P + L; // padding + image + padding + label\n\n      const meta: ThumbMeta = {\n        pageIndex: p.index,\n        width: INNER_W, // bitmap width (for <img> size)\n        height: imgH, // bitmap height (for <img> size)\n        wrapperHeight: wrapH, // full row height used by virtualizer\n        top: offset, // top of the row\n        labelHeight: L,\n        padding: P, // NEW\n      };\n      offset += wrapH + GAP;\n      return meta;\n    });\n\n    this.window = {\n      start: -1,\n      end: -1,\n      items: [],\n      totalHeight: offset - GAP,\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ capability ----------------------------------------- */\n  protected buildCapability(): ThumbnailCapability {\n    return {\n      renderThumb: (idx, dpr) => this.renderThumb(idx, dpr),\n      scrollToThumb: (pageIdx) => this.scrollToThumb(pageIdx),\n    };\n  }\n\n  /* ------------ windowing & viewport state ------------------------- */\n  public updateWindow(scrollY: number, viewportH: number) {\n    const BUF = this.cfg.buffer ?? 3;\n\n    // remember latest viewport metrics for scroll decisions\n    this.scrollY = scrollY;\n    this.viewportH = viewportH;\n\n    /* find first visible */\n    let low = 0,\n      high = this.thumbs.length - 1,\n      first = 0;\n    while (low <= high) {\n      const mid = (low + high) >> 1;\n      const m = this.thumbs[mid];\n      if (m.top + m.wrapperHeight < scrollY) low = mid + 1;\n      else {\n        first = mid;\n        high = mid - 1;\n      }\n    }\n\n    /* find last visible + buffer */\n    let last = first;\n    const limit = scrollY + viewportH;\n    while (last + 1 < this.thumbs.length && this.thumbs[last].top < limit) last++;\n    last = Math.min(this.thumbs.length - 1, last + BUF);\n\n    const start = Math.max(0, first - BUF);\n    if (this.window && start === this.window.start && last === this.window.end) return;\n\n    this.window = {\n      start,\n      end: last,\n      items: this.thumbs.slice(start, last + 1),\n      totalHeight: this.window!.totalHeight,\n    };\n    this.emitWindow.emit(this.window);\n  }\n\n  /* ------------ scroll helper now in plugin ------------------------ */\n  private scrollToThumb(pageIdx: number) {\n    if (!this.window) return;\n    const item = this.thumbs[pageIdx];\n    if (!item) return;\n\n    const behavior = this.cfg.scrollBehavior ?? 'smooth';\n\n    if (this.viewportH <= 0) {\n      // Center the thumbnail in the viewport\n      const top = Math.max(0, item.top - item.wrapperHeight);\n      this.scrollTo$.emit({ top, behavior });\n      return;\n    }\n\n    const margin = 8;\n    const top = item.top;\n    const bottom = item.top + item.wrapperHeight;\n\n    const needsUp = top < this.scrollY + margin;\n    const needsDown = bottom > this.scrollY + this.viewportH - margin;\n\n    if (needsUp) {\n      this.scrollTo$.emit({ top, behavior });\n    } else if (needsDown) {\n      this.scrollTo$.emit({ top: Math.max(0, bottom - this.viewportH), behavior });\n    }\n  }\n\n  /* ------------ thumbnail raster ----------------------------------- */\n  private renderThumb(idx: number, dpr: number) {\n    if (this.taskCache.has(idx)) return this.taskCache.get(idx)!;\n\n    const core = this.coreState.core;\n    const page = core.document!.pages[idx];\n\n    const OUTER_W = this.cfg.width ?? 120;\n    const P = this.cfg.imagePadding ?? 0;\n    const INNER_W = Math.max(1, OUTER_W - 2 * P);\n\n    const scale = INNER_W / page.size.width; // scale to inner width (excludes padding)\n\n    const task = this.renderCapability.renderPageRect({\n      pageIndex: idx,\n      rect: { origin: { x: 0, y: 0 }, size: page.size },\n      options: {\n        scaleFactor: scale,\n        dpr,\n      },\n    });\n\n    this.taskCache.set(idx, task);\n    task.wait(ignore, () => this.taskCache.delete(idx));\n    return task;\n  }\n}\n","import { PluginPackage } from '@embedpdf/core';\nimport { manifest, THUMBNAIL_PLUGIN_ID } from './manifest';\nimport { ThumbnailPluginConfig } from './types';\nimport { ThumbnailPlugin } from './thumbnail-plugin';\n\nexport const ThumbnailPluginPackage: PluginPackage<ThumbnailPlugin, ThumbnailPluginConfig> = {\n  manifest,\n  create: (registry, config) => new ThumbnailPlugin(THUMBNAIL_PLUGIN_ID, registry, config),\n  reducer: () => {},\n  initialState: {},\n};\n\nexport * from './thumbnail-plugin';\nexport * from './types';\nexport * from './manifest';\n"],"names":["top"],"mappings":";;AAGO,MAAM,sBAAsB;AAE5B,MAAM,WAAkD;AAAA,EAC7D,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,SAAS;AAAA,EACT,UAAU,CAAC,WAAW;AAAA,EACtB,UAAU,CAAC,QAAQ;AAAA,EACnB,UAAU,CAAC,QAAQ;AAAA,EACnB,eAAe;AAAA,IACb,SAAS;AAAA,IACT,OAAO;AAAA,IACP,KAAK;AAAA,IACL,QAAQ;AAAA,IACR,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,cAAc;AAAA,EAAA;AAElB;ACLO,MAAM,mBAAN,MAAM,yBAAwB,WAAuD;AAAA,EAmB1F,YACE,IACA,UACQ,KACR;;AACA,UAAM,IAAI,QAAQ;AAFV,SAAA,MAAA;AAlBV,SAAQ,mBAA4C;AACpD,SAAQ,SAAsB,CAAC;AAC/B,SAAQ,SAA6B;AAGrC,SAAQ,YAAoB;AAC5B,SAAQ,UAAkB;AAE1B,SAAiB,aAAa,sBAAmC;AACjE,SAAiB,gBAAgB,cAAwB;AACxC,SAAA,gCAAgB,IAAwC;AACzE,SAAQ,gBAAgB;AAExB,SAAiB,YAAY,sBAAuC;AASlE,SAAK,mBAAmB,KAAK,SAAS,UAAwB,QAAQ,EAAG,SAAS;AAClF,SAAK,qBAAmB,UAAK,SAAS,UAAwB,QAAQ,MAA9C,mBAAiD,eAAc;AAEvF,SAAK,UAAU,SAAS,cAAc,CAAC,SAAS,UAAU;AACxD,WAAK,UAAU,MAAM;AACrB,WAAK,eAAe,KAAK;AAAA,IAAA,CAC1B;AAED,SAAK,UAAU,SAAS,eAAe,CAAC,WAAW;AAC5C,WAAA,cAAc,KAAK,OAAO,OAAO;AAC3B,iBAAA,WAAW,OAAO,SAAS;AAC/B,aAAA,UAAU,OAAO,OAAO;AAAA,MAAA;AAAA,IAC/B,CACD;AAGD,QAAI,KAAK,oBAAoB,KAAK,IAAI,eAAe,OAAO;AAC1D,WAAK,iBAAiB,kBAAkB,CAAC,EAAE,YAAY,iBAAiB;AACtE,aAAK,gBAAgB,CAAC;AACtB,YAAI,CAAC,YAAY;AACV,eAAA,cAAc,aAAa,CAAC;AAAA,QAAA;AAAA,MACnC,CACD;AACD,WAAK,iBAAiB,aAAa,CAAC,EAAE,iBAAiB;AACrD,YAAI,KAAK,eAAe;AACjB,eAAA,cAAc,aAAa,CAAC;AAAA,QAAA;AAAA,MACnC,CACD;AAAA,IAAA;AAAA,EACH;AAAA;AAAA,EAIF,MAAM,aAA4B;AAAA,EAAA;AAAA,EAE3B,eAAe,IAA4C;AACzD,WAAA,KAAK,cAAc,GAAG,EAAE;AAAA,EAAA;AAAA,EAG1B,SAAS,IAA2C;AAClD,WAAA,KAAK,WAAW,GAAG,EAAE;AAAA,EAAA;AAAA,EAGvB,WAAW,IAA+C;AACxD,WAAA,KAAK,UAAU,GAAG,EAAE;AAAA,EAAA;AAAA,EAGrB,eAAe,OAA8B;AACnD,UAAM,OAAO,MAAM;AACf,QAAA,CAAC,KAAK,SAAU;AAEd,UAAA,UAAU,KAAK,IAAI,SAAS;AAC5B,UAAA,IAAI,KAAK,IAAI,eAAe;AAC5B,UAAA,MAAM,KAAK,IAAI,OAAO;AACtB,UAAA,IAAI,KAAK,IAAI,gBAAgB;AAGnC,UAAM,UAAU,KAAK,IAAI,GAAG,UAAU,IAAI,CAAC;AAE3C,QAAI,SAAS;AACb,SAAK,SAAS,KAAK,SAAS,MAAM,IAAI,CAAC,MAAM;AAC3C,YAAM,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK;AACrC,YAAM,OAAO,KAAK,MAAM,UAAU,KAAK;AACjC,YAAA,QAAQ,IAAI,OAAO,IAAI;AAE7B,YAAM,OAAkB;AAAA,QACtB,WAAW,EAAE;AAAA,QACb,OAAO;AAAA;AAAA,QACP,QAAQ;AAAA;AAAA,QACR,eAAe;AAAA;AAAA,QACf,KAAK;AAAA;AAAA,QACL,aAAa;AAAA,QACb,SAAS;AAAA;AAAA,MACX;AACA,gBAAU,QAAQ;AACX,aAAA;AAAA,IAAA,CACR;AAED,SAAK,SAAS;AAAA,MACZ,OAAO;AAAA,MACP,KAAK;AAAA,MACL,OAAO,CAAC;AAAA,MACR,aAAa,SAAS;AAAA,IACxB;AACK,SAAA,WAAW,KAAK,KAAK,MAAM;AAAA,EAAA;AAAA;AAAA,EAIxB,kBAAuC;AACxC,WAAA;AAAA,MACL,aAAa,CAAC,KAAK,QAAQ,KAAK,YAAY,KAAK,GAAG;AAAA,MACpD,eAAe,CAAC,YAAY,KAAK,cAAc,OAAO;AAAA,IACxD;AAAA,EAAA;AAAA;AAAA,EAIK,aAAa,SAAiB,WAAmB;AAChD,UAAA,MAAM,KAAK,IAAI,UAAU;AAG/B,SAAK,UAAU;AACf,SAAK,YAAY;AAGjB,QAAI,MAAM,GACR,OAAO,KAAK,OAAO,SAAS,GAC5B,QAAQ;AACV,WAAO,OAAO,MAAM;AACZ,YAAA,MAAO,MAAM,QAAS;AACtB,YAAA,IAAI,KAAK,OAAO,GAAG;AACzB,UAAI,EAAE,MAAM,EAAE,gBAAgB,eAAe,MAAM;AAAA,WAC9C;AACK,gBAAA;AACR,eAAO,MAAM;AAAA,MAAA;AAAA,IACf;AAIF,QAAI,OAAO;AACX,UAAM,QAAQ,UAAU;AACjB,WAAA,OAAO,IAAI,KAAK,OAAO,UAAU,KAAK,OAAO,IAAI,EAAE,MAAM,MAAO;AACvE,WAAO,KAAK,IAAI,KAAK,OAAO,SAAS,GAAG,OAAO,GAAG;AAElD,UAAM,QAAQ,KAAK,IAAI,GAAG,QAAQ,GAAG;AACjC,QAAA,KAAK,UAAU,UAAU,KAAK,OAAO,SAAS,SAAS,KAAK,OAAO,IAAK;AAE5E,SAAK,SAAS;AAAA,MACZ;AAAA,MACA,KAAK;AAAA,MACL,OAAO,KAAK,OAAO,MAAM,OAAO,OAAO,CAAC;AAAA,MACxC,aAAa,KAAK,OAAQ;AAAA,IAC5B;AACK,SAAA,WAAW,KAAK,KAAK,MAAM;AAAA,EAAA;AAAA;AAAA,EAI1B,cAAc,SAAiB;AACjC,QAAA,CAAC,KAAK,OAAQ;AACZ,UAAA,OAAO,KAAK,OAAO,OAAO;AAChC,QAAI,CAAC,KAAM;AAEL,UAAA,WAAW,KAAK,IAAI,kBAAkB;AAExC,QAAA,KAAK,aAAa,GAAG;AAEvB,YAAMA,OAAM,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,aAAa;AACrD,WAAK,UAAU,KAAK,EAAE,KAAAA,MAAK,UAAU;AACrC;AAAA,IAAA;AAGF,UAAM,SAAS;AACf,UAAM,MAAM,KAAK;AACX,UAAA,SAAS,KAAK,MAAM,KAAK;AAEzB,UAAA,UAAU,MAAM,KAAK,UAAU;AACrC,UAAM,YAAY,SAAS,KAAK,UAAU,KAAK,YAAY;AAE3D,QAAI,SAAS;AACX,WAAK,UAAU,KAAK,EAAE,KAAK,UAAU;AAAA,eAC5B,WAAW;AACpB,WAAK,UAAU,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,SAAS,KAAK,SAAS,GAAG,SAAA,CAAU;AAAA,IAAA;AAAA,EAC7E;AAAA;AAAA,EAIM,YAAY,KAAa,KAAa;AACxC,QAAA,KAAK,UAAU,IAAI,GAAG,EAAU,QAAA,KAAK,UAAU,IAAI,GAAG;AAEpD,UAAA,OAAO,KAAK,UAAU;AAC5B,UAAM,OAAO,KAAK,SAAU,MAAM,GAAG;AAE/B,UAAA,UAAU,KAAK,IAAI,SAAS;AAC5B,UAAA,IAAI,KAAK,IAAI,gBAAgB;AACnC,UAAM,UAAU,KAAK,IAAI,GAAG,UAAU,IAAI,CAAC;AAErC,UAAA,QAAQ,UAAU,KAAK,KAAK;AAE5B,UAAA,OAAO,KAAK,iBAAiB,eAAe;AAAA,MAChD,WAAW;AAAA,MACX,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG,KAAK,MAAM,KAAK,KAAK;AAAA,MAChD,SAAS;AAAA,QACP,aAAa;AAAA,QACb;AAAA,MAAA;AAAA,IACF,CACD;AAEI,SAAA,UAAU,IAAI,KAAK,IAAI;AAC5B,SAAK,KAAK,QAAQ,MAAM,KAAK,UAAU,OAAO,GAAG,CAAC;AAC3C,WAAA;AAAA,EAAA;AAEX;AAtNE,iBAAgB,KAAK;AADhB,IAAM,kBAAN;ACZA,MAAM,yBAAgF;AAAA,EAC3F;AAAA,EACA,QAAQ,CAAC,UAAU,WAAW,IAAI,gBAAgB,qBAAqB,UAAU,MAAM;AAAA,EACvF,SAAS,MAAM;AAAA,EAAC;AAAA,EAChB,cAAc,CAAA;AAChB;"}

package/dist/lib/thumbnail-plugin.d.ts

@@ -1,19 +1,27 @@
 import { BasePlugin, PluginRegistry, Unsubscribe } from '@embedpdf/core';
-import { ThumbnailPluginConfig, ThumbnailCapability } from './types';
+import { ScrollToOptions, ThumbnailPluginConfig, WindowState, ThumbnailCapability } from './types';
 export declare class ThumbnailPlugin extends BasePlugin<ThumbnailPluginConfig, ThumbnailCapability> {
     private cfg;
     static readonly id: "thumbnail";
     private renderCapability;
+    private scrollCapability;
     private thumbs;
     private window;
+    private viewportH;
+    private scrollY;
     private readonly emitWindow;
     private readonly refreshPages$;
     private readonly taskCache;
+    private canAutoScroll;
+    private readonly scrollTo$;
     constructor(id: string, registry: PluginRegistry, cfg: ThumbnailPluginConfig);
     initialize(): Promise<void>;
     onRefreshPages(fn: (pages: number[]) => void): Unsubscribe;
+    onWindow(cb: (w: WindowState) => void): Unsubscribe;
+    onScrollTo(cb: (o: ScrollToOptions) => void): Unsubscribe;
     private setWindowState;
     protected buildCapability(): ThumbnailCapability;
-    private updateWindow;
+    updateWindow(scrollY: number, viewportH: number): void;
+    private scrollToThumb;
     private renderThumb;
 }

package/dist/lib/types.d.ts

@@ -1,18 +1,31 @@
 import { BasePluginConfig } from '@embedpdf/core';
 import { PdfErrorReason, Task } from '@embedpdf/models';
+import { ScrollBehavior } from '@embedpdf/plugin-scroll';
 export interface ThumbnailPluginConfig extends BasePluginConfig {
     width?: number;
     gap?: number;
     buffer?: number;
     labelHeight?: number;
+    autoScroll?: boolean;
+    scrollBehavior?: ScrollBehavior;
+    imagePadding?: number;
+}
+export interface ScrollToOptions {
+    top: number;
+    behavior?: ScrollBehavior;
 }
 export interface ThumbMeta {
     pageIndex: number;
+    /** Inner bitmap size (excludes padding). */
     width: number;
     height: number;
+    /** Total row height (padding*2 + image height + labelHeight). */
     wrapperHeight: number;
+    /** Top offset of the entire row (including padding + label). */
     top: number;
     labelHeight: number;
+    /** Padding applied around the image (px). */
+    padding?: number;
 }
 export interface WindowState {
     start: number;
@@ -21,10 +34,7 @@ export interface WindowState {
     totalHeight: number;
 }
 export interface ThumbnailCapability {
-    /** called from UI on every scroll */
-    setViewport(offsetY: number, viewportH: number): void;
-    /** listen to window changes */
-    onWindow(cb: (w: WindowState) => void): () => void;
+    scrollToThumb(pageIdx: number): void;
     /** lazily render one thumb */
     renderThumb(pageIdx: number, dpr: number): Task<Blob, PdfErrorReason>;
 }

package/dist/preact/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/preact"),t=require("@embedpdf/plugin-thumbnail"),r=require("preact/jsx-runtime");require("preact");const n=require("preact/hooks"),l=require("@embedpdf/models"),o=()=>e.usePlugin(t.ThumbnailPlugin.id),i=()=>e.useCapability(t.ThumbnailPlugin.id);exports.ThumbImg=function({meta:e,style:t,...s}){const{provides:u}=i(),{plugin:c}=o(),[a,p]=n.useState(),d=n.useRef(null),[f,g]=n.useState(0);return n.useEffect((()=>{if(c)return c.onRefreshPages((t=>{t.includes(e.pageIndex)&&g((e=>e+1))}))}),[c]),n.useEffect((()=>{const t=null==u?void 0:u.renderThumb(e.pageIndex,window.devicePixelRatio);return null==t||t.wait((e=>{const t=URL.createObjectURL(e);d.current=t,p(t)}),l.ignore),()=>{d.current?(URL.revokeObjectURL(d.current),d.current=null):null==t||t.abort({code:l.PdfErrorCode.Cancelled,message:"canceled render task"})}}),[u,e.pageIndex,f]),a?r.jsx("img",{src:a,onLoad:()=>{d.current&&(URL.revokeObjectURL(d.current),d.current=null)},style:t,...s}):null},exports.ThumbnailsPane=function({style:e,selectedPage:t,scrollOptions:l={behavior:"smooth",block:"nearest",inline:"nearest"},...o}){const{provides:s}=i(),u=n.useRef(null),[c,a]=n.useState(null);return n.useEffect((()=>null==s?void 0:s.onWindow(a)),[s]),n.useEffect((()=>{const e=u.current;if(!e)return;const t=()=>null==s?void 0:s.setViewport(e.scrollTop,e.clientHeight);return e.addEventListener("scroll",t),()=>e.removeEventListener("scroll",t)}),[s]),n.useEffect((()=>{const e=u.current;e&&s&&0===(null==c?void 0:c.items.length)&&s.setViewport(e.scrollTop,e.clientHeight)}),[c,s]),n.useEffect((()=>{if(!t||!c)return;const e=c.items.find((e=>e.pageIndex+1===t));if(!e)return;const r=u.current;if(!r)return;e.top<r.scrollTop+8?r.scrollTo({top:e.top,...l}):e.top+e.wrapperHeight+e.labelHeight>r.scrollTop+r.clientHeight-8&&r.scrollTo({top:e.top+e.wrapperHeight+e.labelHeight-r.clientHeight,...l})}),[t,c,l]),r.jsx("div",{ref:u,style:{overflowY:"auto",position:"relative",...e},...o,children:r.jsx("div",{style:{height:(null==c?void 0:c.totalHeight)??0,position:"relative"},children:null==c?void 0:c.items.map((e=>o.children(e)))})})},exports.useThumbnailCapability=i,exports.useThumbnailPlugin=o,Object.keys(t).forEach((e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>t[e]})}));
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/preact"),t=require("@embedpdf/plugin-thumbnail"),r=require("preact/jsx-runtime");require("preact");const n=require("preact/hooks"),l=require("@embedpdf/models"),o=()=>e.usePlugin(t.ThumbnailPlugin.id),u=()=>e.useCapability(t.ThumbnailPlugin.id);exports.ThumbImg=function({meta:e,style:t,...i}){const{provides:s}=u(),{plugin:c}=o(),[a,d]=n.useState(),p=n.useRef(null),[f,b]=n.useState(0);return n.useEffect((()=>{if(c)return c.onRefreshPages((t=>{t.includes(e.pageIndex)&&b((e=>e+1))}))}),[c]),n.useEffect((()=>{const t=null==s?void 0:s.renderThumb(e.pageIndex,window.devicePixelRatio);return null==t||t.wait((e=>{const t=URL.createObjectURL(e);p.current=t,d(t)}),l.ignore),()=>{p.current?(URL.revokeObjectURL(p.current),p.current=null):null==t||t.abort({code:l.PdfErrorCode.Cancelled,message:"canceled render task"})}}),[s,e.pageIndex,f]),a?r.jsx("img",{src:a,onLoad:()=>{p.current&&(URL.revokeObjectURL(p.current),p.current=null)},style:t,...i}):null},exports.ThumbnailsPane=function({style:e,scrollOptions:t,selectedPage:l,...u}){const{plugin:i}=o(),s=n.useRef(null),[c,a]=n.useState(null);return n.useEffect((()=>null==i?void 0:i.onWindow(a)),[i]),n.useEffect((()=>{const e=s.current;if(!e)return;const t=()=>null==i?void 0:i.updateWindow(e.scrollTop,e.clientHeight);return e.addEventListener("scroll",t),()=>e.removeEventListener("scroll",t)}),[i]),n.useEffect((()=>{const e=s.current;e&&i&&i.updateWindow(e.scrollTop,e.clientHeight)}),[c,i]),n.useEffect((()=>{const e=s.current;if(e&&i&&c)return i.onScrollTo((({top:t,behavior:r})=>{e.scrollTo({top:t,behavior:r})}))}),[i,!!c]),r.jsx("div",{ref:s,style:{overflowY:"auto",position:"relative",...e},...u,children:r.jsx("div",{style:{height:(null==c?void 0:c.totalHeight)??0,position:"relative"},children:null==c?void 0:c.items.map((e=>u.children(e)))})})},exports.useThumbnailCapability=u,exports.useThumbnailPlugin=o,Object.keys(t).forEach((e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>t[e]})}));
 //# sourceMappingURL=index.cjs.map

package/dist/preact/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnail-img.tsx","../../src/shared/components/thumbnails-pane.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailCapability } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  selectedPage?: number;\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({\n  style,\n  selectedPage,\n  scrollOptions = { behavior: 'smooth', block: 'nearest', inline: 'nearest' },\n  ...props\n}: ThumbnailsProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  /* 1️⃣  subscribe once to window updates */\n  useEffect(() => thumbs?.onWindow(setWindow), [thumbs]);\n\n  /* 2️⃣  keep plugin in sync while the user scrolls */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbs?.setViewport(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbs]);\n\n  /* 3️⃣  kick-start (or re-kick) after document change */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbs) return;\n\n    if (window?.items.length === 0) {\n      thumbs.setViewport(vp.scrollTop, vp.clientHeight);\n    }\n  }, [window, thumbs]);\n\n  /* 4️⃣ whenever selectedPage or window changes, ensure it’s visible */\n  useEffect(() => {\n    if (!selectedPage || !window) return;\n\n    const item = window.items.find((it) => it.pageIndex + 1 === selectedPage);\n    if (!item) return; // not in current window yet → wait for next update\n\n    const vp = viewportRef.current;\n    if (!vp) return;\n\n    // Scroll only if the item is above or below the viewport “padding” zone\n    const margin = 8; // px\n    if (item.top < vp.scrollTop + margin) {\n      vp.scrollTo({ top: item.top, ...scrollOptions });\n    } else if (\n      item.top + item.wrapperHeight + item.labelHeight >\n      vp.scrollTop + vp.clientHeight - margin\n    ) {\n      vp.scrollTo({\n        top: item.top + item.wrapperHeight + item.labelHeight - vp.clientHeight,\n        ...scrollOptions,\n      });\n    }\n  }, [selectedPage, window, scrollOptions]);\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      {/* spacer keeps correct scroll height even before first window arrives */}\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n"],"names":["useThumbnailPlugin","usePlugin","ThumbnailPlugin","id","useThumbnailCapability","useCapability","meta","style","props","provides","thumbs","plugin","thumbnailPlugin","url","setUrl","useState","urlRef","useRef","refreshTick","setRefreshTick","useEffect","onRefreshPages","pages","includes","pageIndex","tick","task","renderThumb","window","devicePixelRatio","wait","blob","objectUrl","URL","createObjectURL","current","ignore","revokeObjectURL","abort","code","PdfErrorCode","Cancelled","message","jsx","src","onLoad","selectedPage","scrollOptions","behavior","block","inline","viewportRef","setWindow","onWindow","vp","onScroll","setViewport","scrollTop","clientHeight","addEventListener","removeEventListener","items","length","item","find","it","top","scrollTo","wrapperHeight","labelHeight","ref","overflowY","position","children","height","totalHeight","map","m"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnail-img.tsx","../../src/shared/components/thumbnails-pane.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  /** @deprecated use scrollToThumb via capability or rely on autoScroll */\n  selectedPage?: number;\n  /** @deprecated behavior is now controlled by ThumbnailPluginConfig.scrollBehavior */\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }: ThumbnailsProps) {\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  // 1) subscribe once to window updates\n  useEffect(() => thumbnailPlugin?.onWindow(setWindow), [thumbnailPlugin]);\n\n  // 2) keep plugin in sync while the user scrolls\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbnailPlugin?.updateWindow(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbnailPlugin]);\n\n  // 3) kick-start after document change\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin) return;\n\n    // push initial metrics\n    thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);\n  }, [window, thumbnailPlugin]);\n\n  // 4) let plugin drive scroll – only after window is set, and only once\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin || !window) return;\n\n    return thumbnailPlugin.onScrollTo(({ top, behavior }) => {\n      vp.scrollTo({ top, behavior });\n    });\n  }, [thumbnailPlugin, !!window]); // Note: !!window to prevent re-subscription on window updates\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n"],"names":["useThumbnailPlugin","usePlugin","ThumbnailPlugin","id","useThumbnailCapability","useCapability","meta","style","props","provides","thumbs","plugin","thumbnailPlugin","url","setUrl","useState","urlRef","useRef","refreshTick","setRefreshTick","useEffect","onRefreshPages","pages","includes","pageIndex","tick","task","renderThumb","window","devicePixelRatio","wait","blob","objectUrl","URL","createObjectURL","current","ignore","revokeObjectURL","abort","code","PdfErrorCode","Cancelled","message","jsx","src","onLoad","scrollOptions","selectedPage","viewportRef","setWindow","onWindow","vp","onScroll","updateWindow","scrollTop","clientHeight","addEventListener","removeEventListener","onScrollTo","top","behavior","scrollTo","ref","overflowY","position","children","height","totalHeight","items","map","m"],"mappings":"iRAGaA,EAAqB,IAAMC,YAA2BC,EAAAA,gBAAgBC,IACtEC,EAAyB,IAAMC,gBAA+BH,EAAAA,gBAAgBC,qBCMpF,UAAkBG,KAAEA,EAAAC,MAAMA,KAAUC,IACzC,MAAQC,SAAUC,GAAWN,KACrBO,OAAQC,GAAoBZ,KAC7Ba,EAAKC,GAAUC,aAChBC,EAASC,SAAsB,OAC9BC,EAAaC,GAAkBJ,EAAAA,SAAS,GAuCxC,OArCPK,EAAAA,WAAU,KACR,GAAKR,EACE,OAAAA,EAAgBS,gBAAgBC,IACjCA,EAAMC,SAASjB,EAAKkB,YACPL,GAACM,GAASA,EAAO,GAAC,GAEpC,GACA,CAACb,IAEJQ,EAAAA,WAAU,KACR,MAAMM,EAAO,MAAAhB,OAAA,EAAAA,EAAQiB,YAAYrB,EAAKkB,UAAWI,OAAOC,kBAOxD,OANM,MAAAH,GAAAA,EAAAI,MAAMC,IACJ,MAAAC,EAAYC,IAAIC,gBAAgBH,GACtCf,EAAOmB,QAAUH,EACjBlB,EAAOkB,EAAS,GACfI,UAEI,KACDpB,EAAOmB,SACLF,IAAAI,gBAAgBrB,EAAOmB,SAC3BnB,EAAOmB,QAAU,MAEjB,MAAAT,GAAAA,EAAMY,MAAM,CACVC,KAAMC,EAAaA,aAAAC,UACnBC,QAAS,wBACV,CAEL,GACC,CAAChC,EAAQJ,EAAKkB,UAAWN,IASrBL,EAAO8B,EAAAA,IAAA,MAAA,CAAIC,IAAK/B,EAAKgC,OAPJ,KAClB7B,EAAOmB,UACLF,IAAAI,gBAAgBrB,EAAOmB,SAC3BnB,EAAOmB,QAAU,KAAA,EAIgC5B,WAAkBC,IAAY,IACrF,yBC1CO,UAAwBD,MAAEA,EAAAuC,cAAOA,eAAeC,KAAiBvC,IACtE,MAAQG,OAAQC,GAAoBZ,IAC9BgD,EAAc/B,SAAuB,OAEpCW,EAAQqB,GAAalC,EAAAA,SAA6B,aAGzDK,EAAAA,WAAU,IAAM,MAAAR,OAAA,EAAAA,EAAiBsC,SAASD,IAAY,CAACrC,IAGvDQ,EAAAA,WAAU,KACR,MAAM+B,EAAKH,EAAYb,QACvB,IAAKgB,EAAI,OACT,MAAMC,EAAW,IAAM,MAAAxC,OAAA,EAAAA,EAAiByC,aAAaF,EAAGG,UAAWH,EAAGI,cAEtE,OADGJ,EAAAK,iBAAiB,SAAUJ,GACvB,IAAMD,EAAGM,oBAAoB,SAAUL,EAAQ,GACrD,CAACxC,IAGJQ,EAAAA,WAAU,KACR,MAAM+B,EAAKH,EAAYb,QAClBgB,GAAOvC,GAGZA,EAAgByC,aAAaF,EAAGG,UAAWH,EAAGI,aAAY,GACzD,CAAC3B,EAAQhB,IAGZQ,EAAAA,WAAU,KACR,MAAM+B,EAAKH,EAAYb,QACvB,GAAKgB,GAAOvC,GAAoBgB,EAEhC,OAAOhB,EAAgB8C,YAAW,EAAGC,MAAKC,eACxCT,EAAGU,SAAS,CAAEF,MAAKC,YAAU,GAC9B,GACA,CAAChD,IAAmBgB,UAGpB,MAAI,CAAAkC,IAAKd,EAAazC,MAAO,CAAEwD,UAAW,OAAQC,SAAU,cAAezD,MAAaC,EACvFyD,eAAC,MAAI,CAAA1D,MAAO,CAAE2D,QAAQ,MAAAtC,SAAAA,EAAQuC,cAAe,EAAGH,SAAU,YACvDC,SAAQ,MAAArC,OAAA,EAAAA,EAAAwC,MAAMC,KAAKC,GAAM9D,EAAMyD,SAASK,QAIjD"}

package/dist/preact/index.js

@@ -7,46 +7,30 @@ import { useRef, useState, useEffect } from "preact/hooks";
 import { ignore, PdfErrorCode } from "@embedpdf/models";
 const useThumbnailPlugin = () => usePlugin(ThumbnailPlugin.id);
 const useThumbnailCapability = () => useCapability(ThumbnailPlugin.id);
-function ThumbnailsPane({
-  style,
-  selectedPage,
-  scrollOptions = { behavior: "smooth", block: "nearest", inline: "nearest" },
-  ...props
-}) {
-  const { provides: thumbs } = useThumbnailCapability();
+function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }) {
+  const { plugin: thumbnailPlugin } = useThumbnailPlugin();
   const viewportRef = useRef(null);
   const [window2, setWindow] = useState(null);
-  useEffect(() => thumbs == null ? void 0 : thumbs.onWindow(setWindow), [thumbs]);
+  useEffect(() => thumbnailPlugin == null ? void 0 : thumbnailPlugin.onWindow(setWindow), [thumbnailPlugin]);
   useEffect(() => {
     const vp = viewportRef.current;
     if (!vp) return;
-    const onScroll = () => thumbs == null ? void 0 : thumbs.setViewport(vp.scrollTop, vp.clientHeight);
+    const onScroll = () => thumbnailPlugin == null ? void 0 : thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);
     vp.addEventListener("scroll", onScroll);
     return () => vp.removeEventListener("scroll", onScroll);
-  }, [thumbs]);
+  }, [thumbnailPlugin]);
   useEffect(() => {
     const vp = viewportRef.current;
-    if (!vp || !thumbs) return;
-    if ((window2 == null ? void 0 : window2.items.length) === 0) {
-      thumbs.setViewport(vp.scrollTop, vp.clientHeight);
-    }
-  }, [window2, thumbs]);
+    if (!vp || !thumbnailPlugin) return;
+    thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);
+  }, [window2, thumbnailPlugin]);
   useEffect(() => {
-    if (!selectedPage || !window2) return;
-    const item = window2.items.find((it) => it.pageIndex + 1 === selectedPage);
-    if (!item) return;
     const vp = viewportRef.current;
-    if (!vp) return;
-    const margin = 8;
-    if (item.top < vp.scrollTop + margin) {
-      vp.scrollTo({ top: item.top, ...scrollOptions });
-    } else if (item.top + item.wrapperHeight + item.labelHeight > vp.scrollTop + vp.clientHeight - margin) {
-      vp.scrollTo({
-        top: item.top + item.wrapperHeight + item.labelHeight - vp.clientHeight,
-        ...scrollOptions
-      });
-    }
-  }, [selectedPage, window2, scrollOptions]);
+    if (!vp || !thumbnailPlugin || !window2) return;
+    return thumbnailPlugin.onScrollTo(({ top, behavior }) => {
+      vp.scrollTo({ top, behavior });
+    });
+  }, [thumbnailPlugin, !!window2]);
   return /* @__PURE__ */ jsx("div", { ref: viewportRef, style: { overflowY: "auto", position: "relative", ...style }, ...props, children: /* @__PURE__ */ jsx("div", { style: { height: (window2 == null ? void 0 : window2.totalHeight) ?? 0, position: "relative" }, children: window2 == null ? void 0 : window2.items.map((m) => props.children(m)) }) });
 }
 function ThumbImg({ meta, style, ...props }) {

package/dist/preact/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnails-pane.tsx","../../src/shared/components/thumbnail-img.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailCapability } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  selectedPage?: number;\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({\n  style,\n  selectedPage,\n  scrollOptions = { behavior: 'smooth', block: 'nearest', inline: 'nearest' },\n  ...props\n}: ThumbnailsProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  /* 1️⃣  subscribe once to window updates */\n  useEffect(() => thumbs?.onWindow(setWindow), [thumbs]);\n\n  /* 2️⃣  keep plugin in sync while the user scrolls */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbs?.setViewport(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbs]);\n\n  /* 3️⃣  kick-start (or re-kick) after document change */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbs) return;\n\n    if (window?.items.length === 0) {\n      thumbs.setViewport(vp.scrollTop, vp.clientHeight);\n    }\n  }, [window, thumbs]);\n\n  /* 4️⃣ whenever selectedPage or window changes, ensure it’s visible */\n  useEffect(() => {\n    if (!selectedPage || !window) return;\n\n    const item = window.items.find((it) => it.pageIndex + 1 === selectedPage);\n    if (!item) return; // not in current window yet → wait for next update\n\n    const vp = viewportRef.current;\n    if (!vp) return;\n\n    // Scroll only if the item is above or below the viewport “padding” zone\n    const margin = 8; // px\n    if (item.top < vp.scrollTop + margin) {\n      vp.scrollTo({ top: item.top, ...scrollOptions });\n    } else if (\n      item.top + item.wrapperHeight + item.labelHeight >\n      vp.scrollTop + vp.clientHeight - margin\n    ) {\n      vp.scrollTo({\n        top: item.top + item.wrapperHeight + item.labelHeight - vp.clientHeight,\n        ...scrollOptions,\n      });\n    }\n  }, [selectedPage, window, scrollOptions]);\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      {/* spacer keeps correct scroll height even before first window arrives */}\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n"],"names":["window"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnails-pane.tsx","../../src/shared/components/thumbnail-img.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  /** @deprecated use scrollToThumb via capability or rely on autoScroll */\n  selectedPage?: number;\n  /** @deprecated behavior is now controlled by ThumbnailPluginConfig.scrollBehavior */\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }: ThumbnailsProps) {\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  // 1) subscribe once to window updates\n  useEffect(() => thumbnailPlugin?.onWindow(setWindow), [thumbnailPlugin]);\n\n  // 2) keep plugin in sync while the user scrolls\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbnailPlugin?.updateWindow(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbnailPlugin]);\n\n  // 3) kick-start after document change\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin) return;\n\n    // push initial metrics\n    thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);\n  }, [window, thumbnailPlugin]);\n\n  // 4) let plugin drive scroll – only after window is set, and only once\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin || !window) return;\n\n    return thumbnailPlugin.onScrollTo(({ top, behavior }) => {\n      vp.scrollTo({ top, behavior });\n    });\n  }, [thumbnailPlugin, !!window]); // Note: !!window to prevent re-subscription on window updates\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n"],"names":["window"],"mappings":"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"}

package/dist/react/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/react"),t=require("@embedpdf/plugin-thumbnail"),r=require("react/jsx-runtime"),n=require("react"),l=require("@embedpdf/models"),i=()=>e.usePlugin(t.ThumbnailPlugin.id),o=()=>e.useCapability(t.ThumbnailPlugin.id);exports.ThumbImg=function({meta:e,style:t,...s}){const{provides:u}=o(),{plugin:c}=i(),[a,d]=n.useState(),p=n.useRef(null),[f,g]=n.useState(0);return n.useEffect((()=>{if(c)return c.onRefreshPages((t=>{t.includes(e.pageIndex)&&g((e=>e+1))}))}),[c]),n.useEffect((()=>{const t=null==u?void 0:u.renderThumb(e.pageIndex,window.devicePixelRatio);return null==t||t.wait((e=>{const t=URL.createObjectURL(e);p.current=t,d(t)}),l.ignore),()=>{p.current?(URL.revokeObjectURL(p.current),p.current=null):null==t||t.abort({code:l.PdfErrorCode.Cancelled,message:"canceled render task"})}}),[u,e.pageIndex,f]),a?r.jsx("img",{src:a,onLoad:()=>{p.current&&(URL.revokeObjectURL(p.current),p.current=null)},style:t,...s}):null},exports.ThumbnailsPane=function({style:e,selectedPage:t,scrollOptions:l={behavior:"smooth",block:"nearest",inline:"nearest"},...i}){const{provides:s}=o(),u=n.useRef(null),[c,a]=n.useState(null);return n.useEffect((()=>null==s?void 0:s.onWindow(a)),[s]),n.useEffect((()=>{const e=u.current;if(!e)return;const t=()=>null==s?void 0:s.setViewport(e.scrollTop,e.clientHeight);return e.addEventListener("scroll",t),()=>e.removeEventListener("scroll",t)}),[s]),n.useEffect((()=>{const e=u.current;e&&s&&0===(null==c?void 0:c.items.length)&&s.setViewport(e.scrollTop,e.clientHeight)}),[c,s]),n.useEffect((()=>{if(!t||!c)return;const e=c.items.find((e=>e.pageIndex+1===t));if(!e)return;const r=u.current;if(!r)return;e.top<r.scrollTop+8?r.scrollTo({top:e.top,...l}):e.top+e.wrapperHeight+e.labelHeight>r.scrollTop+r.clientHeight-8&&r.scrollTo({top:e.top+e.wrapperHeight+e.labelHeight-r.clientHeight,...l})}),[t,c,l]),r.jsx("div",{ref:u,style:{overflowY:"auto",position:"relative",...e},...i,children:r.jsx("div",{style:{height:(null==c?void 0:c.totalHeight)??0,position:"relative"},children:null==c?void 0:c.items.map((e=>i.children(e)))})})},exports.useThumbnailCapability=o,exports.useThumbnailPlugin=i,Object.keys(t).forEach((e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>t[e]})}));
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/react"),t=require("@embedpdf/plugin-thumbnail"),r=require("react/jsx-runtime"),n=require("react"),l=require("@embedpdf/models"),o=()=>e.usePlugin(t.ThumbnailPlugin.id),u=()=>e.useCapability(t.ThumbnailPlugin.id);exports.ThumbImg=function({meta:e,style:t,...i}){const{provides:s}=u(),{plugin:c}=o(),[a,d]=n.useState(),p=n.useRef(null),[f,b]=n.useState(0);return n.useEffect((()=>{if(c)return c.onRefreshPages((t=>{t.includes(e.pageIndex)&&b((e=>e+1))}))}),[c]),n.useEffect((()=>{const t=null==s?void 0:s.renderThumb(e.pageIndex,window.devicePixelRatio);return null==t||t.wait((e=>{const t=URL.createObjectURL(e);p.current=t,d(t)}),l.ignore),()=>{p.current?(URL.revokeObjectURL(p.current),p.current=null):null==t||t.abort({code:l.PdfErrorCode.Cancelled,message:"canceled render task"})}}),[s,e.pageIndex,f]),a?r.jsx("img",{src:a,onLoad:()=>{p.current&&(URL.revokeObjectURL(p.current),p.current=null)},style:t,...i}):null},exports.ThumbnailsPane=function({style:e,scrollOptions:t,selectedPage:l,...u}){const{plugin:i}=o(),s=n.useRef(null),[c,a]=n.useState(null);return n.useEffect((()=>null==i?void 0:i.onWindow(a)),[i]),n.useEffect((()=>{const e=s.current;if(!e)return;const t=()=>null==i?void 0:i.updateWindow(e.scrollTop,e.clientHeight);return e.addEventListener("scroll",t),()=>e.removeEventListener("scroll",t)}),[i]),n.useEffect((()=>{const e=s.current;e&&i&&i.updateWindow(e.scrollTop,e.clientHeight)}),[c,i]),n.useEffect((()=>{const e=s.current;if(e&&i&&c)return i.onScrollTo((({top:t,behavior:r})=>{e.scrollTo({top:t,behavior:r})}))}),[i,!!c]),r.jsx("div",{ref:s,style:{overflowY:"auto",position:"relative",...e},...u,children:r.jsx("div",{style:{height:(null==c?void 0:c.totalHeight)??0,position:"relative"},children:null==c?void 0:c.items.map((e=>u.children(e)))})})},exports.useThumbnailCapability=u,exports.useThumbnailPlugin=o,Object.keys(t).forEach((e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>t[e]})}));
 //# sourceMappingURL=index.cjs.map

package/dist/react/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnail-img.tsx","../../src/shared/components/thumbnails-pane.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailCapability } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  selectedPage?: number;\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({\n  style,\n  selectedPage,\n  scrollOptions = { behavior: 'smooth', block: 'nearest', inline: 'nearest' },\n  ...props\n}: ThumbnailsProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  /* 1️⃣  subscribe once to window updates */\n  useEffect(() => thumbs?.onWindow(setWindow), [thumbs]);\n\n  /* 2️⃣  keep plugin in sync while the user scrolls */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbs?.setViewport(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbs]);\n\n  /* 3️⃣  kick-start (or re-kick) after document change */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbs) return;\n\n    if (window?.items.length === 0) {\n      thumbs.setViewport(vp.scrollTop, vp.clientHeight);\n    }\n  }, [window, thumbs]);\n\n  /* 4️⃣ whenever selectedPage or window changes, ensure it’s visible */\n  useEffect(() => {\n    if (!selectedPage || !window) return;\n\n    const item = window.items.find((it) => it.pageIndex + 1 === selectedPage);\n    if (!item) return; // not in current window yet → wait for next update\n\n    const vp = viewportRef.current;\n    if (!vp) return;\n\n    // Scroll only if the item is above or below the viewport “padding” zone\n    const margin = 8; // px\n    if (item.top < vp.scrollTop + margin) {\n      vp.scrollTo({ top: item.top, ...scrollOptions });\n    } else if (\n      item.top + item.wrapperHeight + item.labelHeight >\n      vp.scrollTop + vp.clientHeight - margin\n    ) {\n      vp.scrollTo({\n        top: item.top + item.wrapperHeight + item.labelHeight - vp.clientHeight,\n        ...scrollOptions,\n      });\n    }\n  }, [selectedPage, window, scrollOptions]);\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      {/* spacer keeps correct scroll height even before first window arrives */}\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n"],"names":["useThumbnailPlugin","usePlugin","ThumbnailPlugin","id","useThumbnailCapability","useCapability","meta","style","props","provides","thumbs","plugin","thumbnailPlugin","url","setUrl","useState","urlRef","useRef","refreshTick","setRefreshTick","useEffect","onRefreshPages","pages","includes","pageIndex","tick","task","renderThumb","window","devicePixelRatio","wait","blob","objectUrl","URL","createObjectURL","current","ignore","revokeObjectURL","abort","code","PdfErrorCode","Cancelled","message","jsx","src","onLoad","selectedPage","scrollOptions","behavior","block","inline","viewportRef","setWindow","onWindow","vp","onScroll","setViewport","scrollTop","clientHeight","addEventListener","removeEventListener","items","length","item","find","it","top","scrollTo","wrapperHeight","labelHeight","ref","overflowY","position","children","height","totalHeight","map","m"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnail-img.tsx","../../src/shared/components/thumbnails-pane.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  /** @deprecated use scrollToThumb via capability or rely on autoScroll */\n  selectedPage?: number;\n  /** @deprecated behavior is now controlled by ThumbnailPluginConfig.scrollBehavior */\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }: ThumbnailsProps) {\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  // 1) subscribe once to window updates\n  useEffect(() => thumbnailPlugin?.onWindow(setWindow), [thumbnailPlugin]);\n\n  // 2) keep plugin in sync while the user scrolls\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbnailPlugin?.updateWindow(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbnailPlugin]);\n\n  // 3) kick-start after document change\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin) return;\n\n    // push initial metrics\n    thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);\n  }, [window, thumbnailPlugin]);\n\n  // 4) let plugin drive scroll – only after window is set, and only once\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin || !window) return;\n\n    return thumbnailPlugin.onScrollTo(({ top, behavior }) => {\n      vp.scrollTo({ top, behavior });\n    });\n  }, [thumbnailPlugin, !!window]); // Note: !!window to prevent re-subscription on window updates\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n"],"names":["useThumbnailPlugin","usePlugin","ThumbnailPlugin","id","useThumbnailCapability","useCapability","meta","style","props","provides","thumbs","plugin","thumbnailPlugin","url","setUrl","useState","urlRef","useRef","refreshTick","setRefreshTick","useEffect","onRefreshPages","pages","includes","pageIndex","tick","task","renderThumb","window","devicePixelRatio","wait","blob","objectUrl","URL","createObjectURL","current","ignore","revokeObjectURL","abort","code","PdfErrorCode","Cancelled","message","jsx","src","onLoad","scrollOptions","selectedPage","viewportRef","setWindow","onWindow","vp","onScroll","updateWindow","scrollTop","clientHeight","addEventListener","removeEventListener","onScrollTo","top","behavior","scrollTo","ref","overflowY","position","children","height","totalHeight","items","map","m"],"mappings":"gPAGaA,EAAqB,IAAMC,YAA2BC,EAAAA,gBAAgBC,IACtEC,EAAyB,IAAMC,gBAA+BH,EAAAA,gBAAgBC,qBCMpF,UAAkBG,KAAEA,EAAAC,MAAMA,KAAUC,IACzC,MAAQC,SAAUC,GAAWN,KACrBO,OAAQC,GAAoBZ,KAC7Ba,EAAKC,GAAUC,aAChBC,EAASC,SAAsB,OAC9BC,EAAaC,GAAkBJ,EAAAA,SAAS,GAuCxC,OArCPK,EAAAA,WAAU,KACR,GAAKR,EACE,OAAAA,EAAgBS,gBAAgBC,IACjCA,EAAMC,SAASjB,EAAKkB,YACPL,GAACM,GAASA,EAAO,GAAC,GAEpC,GACA,CAACb,IAEJQ,EAAAA,WAAU,KACR,MAAMM,EAAO,MAAAhB,OAAA,EAAAA,EAAQiB,YAAYrB,EAAKkB,UAAWI,OAAOC,kBAOxD,OANM,MAAAH,GAAAA,EAAAI,MAAMC,IACJ,MAAAC,EAAYC,IAAIC,gBAAgBH,GACtCf,EAAOmB,QAAUH,EACjBlB,EAAOkB,EAAS,GACfI,UAEI,KACDpB,EAAOmB,SACLF,IAAAI,gBAAgBrB,EAAOmB,SAC3BnB,EAAOmB,QAAU,MAEjB,MAAAT,GAAAA,EAAMY,MAAM,CACVC,KAAMC,EAAaA,aAAAC,UACnBC,QAAS,wBACV,CAEL,GACC,CAAChC,EAAQJ,EAAKkB,UAAWN,IASrBL,EAAO8B,EAAAA,IAAA,MAAA,CAAIC,IAAK/B,EAAKgC,OAPJ,KAClB7B,EAAOmB,UACLF,IAAAI,gBAAgBrB,EAAOmB,SAC3BnB,EAAOmB,QAAU,KAAA,EAIgC5B,WAAkBC,IAAY,IACrF,yBC1CO,UAAwBD,MAAEA,EAAAuC,cAAOA,eAAeC,KAAiBvC,IACtE,MAAQG,OAAQC,GAAoBZ,IAC9BgD,EAAc/B,SAAuB,OAEpCW,EAAQqB,GAAalC,EAAAA,SAA6B,aAGzDK,EAAAA,WAAU,IAAM,MAAAR,OAAA,EAAAA,EAAiBsC,SAASD,IAAY,CAACrC,IAGvDQ,EAAAA,WAAU,KACR,MAAM+B,EAAKH,EAAYb,QACvB,IAAKgB,EAAI,OACT,MAAMC,EAAW,IAAM,MAAAxC,OAAA,EAAAA,EAAiByC,aAAaF,EAAGG,UAAWH,EAAGI,cAEtE,OADGJ,EAAAK,iBAAiB,SAAUJ,GACvB,IAAMD,EAAGM,oBAAoB,SAAUL,EAAQ,GACrD,CAACxC,IAGJQ,EAAAA,WAAU,KACR,MAAM+B,EAAKH,EAAYb,QAClBgB,GAAOvC,GAGZA,EAAgByC,aAAaF,EAAGG,UAAWH,EAAGI,aAAY,GACzD,CAAC3B,EAAQhB,IAGZQ,EAAAA,WAAU,KACR,MAAM+B,EAAKH,EAAYb,QACvB,GAAKgB,GAAOvC,GAAoBgB,EAEhC,OAAOhB,EAAgB8C,YAAW,EAAGC,MAAKC,eACxCT,EAAGU,SAAS,CAAEF,MAAKC,YAAU,GAC9B,GACA,CAAChD,IAAmBgB,UAGpB,MAAI,CAAAkC,IAAKd,EAAazC,MAAO,CAAEwD,UAAW,OAAQC,SAAU,cAAezD,MAAaC,EACvFyD,eAAC,MAAI,CAAA1D,MAAO,CAAE2D,QAAQ,MAAAtC,SAAAA,EAAQuC,cAAe,EAAGH,SAAU,YACvDC,SAAQ,MAAArC,OAAA,EAAAA,EAAAwC,MAAMC,KAAKC,GAAM9D,EAAMyD,SAASK,QAIjD"}

package/dist/react/index.js

@@ -6,46 +6,30 @@ import { useRef, useState, useEffect } from "react";
 import { ignore, PdfErrorCode } from "@embedpdf/models";
 const useThumbnailPlugin = () => usePlugin(ThumbnailPlugin.id);
 const useThumbnailCapability = () => useCapability(ThumbnailPlugin.id);
-function ThumbnailsPane({
-  style,
-  selectedPage,
-  scrollOptions = { behavior: "smooth", block: "nearest", inline: "nearest" },
-  ...props
-}) {
-  const { provides: thumbs } = useThumbnailCapability();
+function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }) {
+  const { plugin: thumbnailPlugin } = useThumbnailPlugin();
   const viewportRef = useRef(null);
   const [window2, setWindow] = useState(null);
-  useEffect(() => thumbs == null ? void 0 : thumbs.onWindow(setWindow), [thumbs]);
+  useEffect(() => thumbnailPlugin == null ? void 0 : thumbnailPlugin.onWindow(setWindow), [thumbnailPlugin]);
   useEffect(() => {
     const vp = viewportRef.current;
     if (!vp) return;
-    const onScroll = () => thumbs == null ? void 0 : thumbs.setViewport(vp.scrollTop, vp.clientHeight);
+    const onScroll = () => thumbnailPlugin == null ? void 0 : thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);
     vp.addEventListener("scroll", onScroll);
     return () => vp.removeEventListener("scroll", onScroll);
-  }, [thumbs]);
+  }, [thumbnailPlugin]);
   useEffect(() => {
     const vp = viewportRef.current;
-    if (!vp || !thumbs) return;
-    if ((window2 == null ? void 0 : window2.items.length) === 0) {
-      thumbs.setViewport(vp.scrollTop, vp.clientHeight);
-    }
-  }, [window2, thumbs]);
+    if (!vp || !thumbnailPlugin) return;
+    thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);
+  }, [window2, thumbnailPlugin]);
   useEffect(() => {
-    if (!selectedPage || !window2) return;
-    const item = window2.items.find((it) => it.pageIndex + 1 === selectedPage);
-    if (!item) return;
     const vp = viewportRef.current;
-    if (!vp) return;
-    const margin = 8;
-    if (item.top < vp.scrollTop + margin) {
-      vp.scrollTo({ top: item.top, ...scrollOptions });
-    } else if (item.top + item.wrapperHeight + item.labelHeight > vp.scrollTop + vp.clientHeight - margin) {
-      vp.scrollTo({
-        top: item.top + item.wrapperHeight + item.labelHeight - vp.clientHeight,
-        ...scrollOptions
-      });
-    }
-  }, [selectedPage, window2, scrollOptions]);
+    if (!vp || !thumbnailPlugin || !window2) return;
+    return thumbnailPlugin.onScrollTo(({ top, behavior }) => {
+      vp.scrollTo({ top, behavior });
+    });
+  }, [thumbnailPlugin, !!window2]);
   return /* @__PURE__ */ jsx("div", { ref: viewportRef, style: { overflowY: "auto", position: "relative", ...style }, ...props, children: /* @__PURE__ */ jsx("div", { style: { height: (window2 == null ? void 0 : window2.totalHeight) ?? 0, position: "relative" }, children: window2 == null ? void 0 : window2.items.map((m) => props.children(m)) }) });
 }
 function ThumbImg({ meta, style, ...props }) {

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnails-pane.tsx","../../src/shared/components/thumbnail-img.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailCapability } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  selectedPage?: number;\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({\n  style,\n  selectedPage,\n  scrollOptions = { behavior: 'smooth', block: 'nearest', inline: 'nearest' },\n  ...props\n}: ThumbnailsProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  /* 1️⃣  subscribe once to window updates */\n  useEffect(() => thumbs?.onWindow(setWindow), [thumbs]);\n\n  /* 2️⃣  keep plugin in sync while the user scrolls */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbs?.setViewport(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbs]);\n\n  /* 3️⃣  kick-start (or re-kick) after document change */\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbs) return;\n\n    if (window?.items.length === 0) {\n      thumbs.setViewport(vp.scrollTop, vp.clientHeight);\n    }\n  }, [window, thumbs]);\n\n  /* 4️⃣ whenever selectedPage or window changes, ensure it’s visible */\n  useEffect(() => {\n    if (!selectedPage || !window) return;\n\n    const item = window.items.find((it) => it.pageIndex + 1 === selectedPage);\n    if (!item) return; // not in current window yet → wait for next update\n\n    const vp = viewportRef.current;\n    if (!vp) return;\n\n    // Scroll only if the item is above or below the viewport “padding” zone\n    const margin = 8; // px\n    if (item.top < vp.scrollTop + margin) {\n      vp.scrollTo({ top: item.top, ...scrollOptions });\n    } else if (\n      item.top + item.wrapperHeight + item.labelHeight >\n      vp.scrollTop + vp.clientHeight - margin\n    ) {\n      vp.scrollTo({\n        top: item.top + item.wrapperHeight + item.labelHeight - vp.clientHeight,\n        ...scrollOptions,\n      });\n    }\n  }, [selectedPage, window, scrollOptions]);\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      {/* spacer keeps correct scroll height even before first window arrives */}\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n"],"names":["window"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/shared/hooks/use-thumbnail.ts","../../src/shared/components/thumbnails-pane.tsx","../../src/shared/components/thumbnail-img.tsx"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/@framework';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","import { useEffect, useRef, useState, HTMLAttributes, CSSProperties, ReactNode } from '@framework';\nimport { ThumbMeta, WindowState } from '@embedpdf/plugin-thumbnail';\nimport { useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {\n  style?: CSSProperties;\n  children: (m: ThumbMeta) => ReactNode;\n  /** @deprecated use scrollToThumb via capability or rely on autoScroll */\n  selectedPage?: number;\n  /** @deprecated behavior is now controlled by ThumbnailPluginConfig.scrollBehavior */\n  scrollOptions?: ScrollIntoViewOptions;\n};\n\nexport function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }: ThumbnailsProps) {\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const viewportRef = useRef<HTMLDivElement>(null);\n\n  const [window, setWindow] = useState<WindowState | null>(null);\n\n  // 1) subscribe once to window updates\n  useEffect(() => thumbnailPlugin?.onWindow(setWindow), [thumbnailPlugin]);\n\n  // 2) keep plugin in sync while the user scrolls\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp) return;\n    const onScroll = () => thumbnailPlugin?.updateWindow(vp.scrollTop, vp.clientHeight);\n    vp.addEventListener('scroll', onScroll);\n    return () => vp.removeEventListener('scroll', onScroll);\n  }, [thumbnailPlugin]);\n\n  // 3) kick-start after document change\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin) return;\n\n    // push initial metrics\n    thumbnailPlugin.updateWindow(vp.scrollTop, vp.clientHeight);\n  }, [window, thumbnailPlugin]);\n\n  // 4) let plugin drive scroll – only after window is set, and only once\n  useEffect(() => {\n    const vp = viewportRef.current;\n    if (!vp || !thumbnailPlugin || !window) return;\n\n    return thumbnailPlugin.onScrollTo(({ top, behavior }) => {\n      vp.scrollTo({ top, behavior });\n    });\n  }, [thumbnailPlugin, !!window]); // Note: !!window to prevent re-subscription on window updates\n\n  return (\n    <div ref={viewportRef} style={{ overflowY: 'auto', position: 'relative', ...style }} {...props}>\n      <div style={{ height: window?.totalHeight ?? 0, position: 'relative' }}>\n        {window?.items.map((m) => props.children(m))}\n      </div>\n    </div>\n  );\n}\n","import { useEffect, useState, useRef, HTMLAttributes, CSSProperties, Fragment } from '@framework';\nimport { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\n\ntype ThumbnailImgProps = Omit<HTMLAttributes<HTMLImageElement>, 'style'> & {\n  style?: CSSProperties;\n  meta: ThumbMeta;\n};\n\nexport function ThumbImg({ meta, style, ...props }: ThumbnailImgProps) {\n  const { provides: thumbs } = useThumbnailCapability();\n  const { plugin: thumbnailPlugin } = useThumbnailPlugin();\n  const [url, setUrl] = useState<string>();\n  const urlRef = useRef<string | null>(null);\n  const [refreshTick, setRefreshTick] = useState(0);\n\n  useEffect(() => {\n    if (!thumbnailPlugin) return;\n    return thumbnailPlugin.onRefreshPages((pages) => {\n      if (pages.includes(meta.pageIndex)) {\n        setRefreshTick((tick) => tick + 1);\n      }\n    });\n  }, [thumbnailPlugin]);\n\n  useEffect(() => {\n    const task = thumbs?.renderThumb(meta.pageIndex, window.devicePixelRatio);\n    task?.wait((blob) => {\n      const objectUrl = URL.createObjectURL(blob);\n      urlRef.current = objectUrl;\n      setUrl(objectUrl);\n    }, ignore);\n\n    return () => {\n      if (urlRef.current) {\n        URL.revokeObjectURL(urlRef.current);\n        urlRef.current = null;\n      } else {\n        task?.abort({\n          code: PdfErrorCode.Cancelled,\n          message: 'canceled render task',\n        });\n      }\n    };\n  }, [thumbs, meta.pageIndex, refreshTick]);\n\n  const handleImageLoad = () => {\n    if (urlRef.current) {\n      URL.revokeObjectURL(urlRef.current);\n      urlRef.current = null;\n    }\n  };\n\n  return url ? <img src={url} onLoad={handleImageLoad} style={style} {...props} /> : null;\n}\n"],"names":["window"],"mappings":"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"}

package/dist/shared-preact/components/thumbnails-pane.d.ts

@@ -3,8 +3,10 @@ import { ThumbMeta } from '../../lib/index.ts';
 type ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {
     style?: CSSProperties;
     children: (m: ThumbMeta) => ReactNode;
+    /** @deprecated use scrollToThumb via capability or rely on autoScroll */
     selectedPage?: number;
+    /** @deprecated behavior is now controlled by ThumbnailPluginConfig.scrollBehavior */
     scrollOptions?: ScrollIntoViewOptions;
 };
-export declare function ThumbnailsPane({ style, selectedPage, scrollOptions, ...props }: ThumbnailsProps): import("preact").JSX.Element;
+export declare function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }: ThumbnailsProps): import("preact").JSX.Element;
 export {};

package/dist/shared-react/components/thumbnails-pane.d.ts

@@ -3,8 +3,10 @@ import { ThumbMeta } from '../../lib/index.ts';
 type ThumbnailsProps = Omit<HTMLAttributes<HTMLDivElement>, 'style' | 'children'> & {
     style?: CSSProperties;
     children: (m: ThumbMeta) => ReactNode;
+    /** @deprecated use scrollToThumb via capability or rely on autoScroll */
     selectedPage?: number;
+    /** @deprecated behavior is now controlled by ThumbnailPluginConfig.scrollBehavior */
     scrollOptions?: ScrollIntoViewOptions;
 };
-export declare function ThumbnailsPane({ style, selectedPage, scrollOptions, ...props }: ThumbnailsProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThumbnailsPane({ style, scrollOptions, selectedPage, ...props }: ThumbnailsProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/vue/components/index.d.ts

@@ -0,0 +1,2 @@
+export { default as ThumbnailsPane } from './thumbnails-pane.vue';
+export { default as ThumbImg } from './thumbnail-img.vue';

package/dist/vue/components/thumbnail-img.vue.d.ts

@@ -0,0 +1,6 @@
+import { ThumbMeta } from '../../lib/index.ts';
+type __VLS_Props = {
+    meta: ThumbMeta;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/vue/components/thumbnails-pane.vue.d.ts

@@ -0,0 +1,14 @@
+declare var __VLS_1: {
+    meta: any;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_component: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/vue/hooks/index.d.ts

@@ -0,0 +1 @@
+export * from './use-thumbnail';

package/dist/vue/hooks/use-thumbnail.d.ts

@@ -0,0 +1,3 @@
+import { ThumbnailPlugin } from '../../lib/index.ts';
+export declare const useThumbnailPlugin: () => import('@embedpdf/core/vue').PluginState<ThumbnailPlugin>;
+export declare const useThumbnailCapability: () => import('@embedpdf/core/vue').CapabilityState<Readonly<import('../../lib/index.ts').ThumbnailCapability>>;

package/dist/vue/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@embedpdf/core/vue"),l=require("@embedpdf/plugin-thumbnail"),n=require("vue"),t=require("@embedpdf/models"),o=()=>e.usePlugin(l.ThumbnailPlugin.id),u=()=>e.useCapability(l.ThumbnailPlugin.id),r=n.defineComponent({__name:"thumbnails-pane",setup(e){const l=n.useAttrs(),{plugin:t}=o(),u=n.ref(null),r=n.ref(null);let a=null,i=null;return n.watchEffect((e=>{t.value&&(null==a||a(),a=t.value.onWindow((e=>r.value=e)),e((()=>null==a?void 0:a())))})),n.onMounted((()=>{const e=u.value;if(!e||!t.value)return;const l=()=>t.value.updateWindow(e.scrollTop,e.clientHeight);e.addEventListener("scroll",l),t.value.updateWindow(e.scrollTop,e.clientHeight),n.onBeforeUnmount((()=>{e.removeEventListener("scroll",l)}))})),n.watchEffect((e=>{const l=u.value;l&&t.value&&r.value&&(i=t.value.onScrollTo((({top:e,behavior:t})=>{n.nextTick((()=>{l.scrollTo({top:e,behavior:t})}))})),e((()=>null==i?void 0:i())))})),n.onBeforeUnmount((()=>{null==a||a(),null==i||i()})),(e,t)=>{var o,a;return n.openBlock(),n.createElementBlock("div",n.mergeProps({ref_key:"viewportRef",ref:u,style:{overflowY:"auto",position:"relative"}},n.unref(l)),[n.createElementVNode("div",{style:n.normalizeStyle({height:((null==(o=r.value)?void 0:o.totalHeight)??0)+"px",position:"relative"})},[(n.openBlock(!0),n.createElementBlock(n.Fragment,null,n.renderList((null==(a=r.value)?void 0:a.items)??[],(l=>n.renderSlot(e.$slots,"default",{key:l.pageIndex,meta:l}))),128))],4)],16)}}}),a=["src"],i=n.defineComponent({__name:"thumbnail-img",props:{meta:{}},setup(e){const l=e,r=n.useAttrs(),{provides:i}=u(),{plugin:s}=o(),c=n.ref(null);let d=null;const p=n.ref(0);let m=null;function v(){d&&(URL.revokeObjectURL(d),d=null)}n.watchEffect((e=>{s.value&&(null==m||m(),m=s.value.onRefreshPages((e=>{e.includes(l.meta.pageIndex)&&p.value++})),e((()=>null==m?void 0:m())))}));let f=null;return n.watch((()=>[l.meta.pageIndex,p.value,!!i.value]),(()=>{null==f||f(),function(){if(!i.value)return;const e=i.value.renderThumb(l.meta.pageIndex,window.devicePixelRatio);f=()=>e.abort({code:t.PdfErrorCode.Cancelled,message:"canceled render task"}),e.wait((e=>{v();const l=URL.createObjectURL(e);d=l,c.value=l}),t.ignore)}()}),{immediate:!0}),n.onBeforeUnmount((()=>{null==f||f(),v()})),(e,l)=>c.value?(n.openBlock(),n.createElementBlock("img",n.mergeProps({key:0,src:c.value},n.unref(r),{onLoad:v}),null,16,a)):n.createCommentVNode("",!0)}});exports.ThumbImg=i,exports.ThumbnailsPane=r,exports.useThumbnailCapability=u,exports.useThumbnailPlugin=o,Object.keys(l).forEach((e=>{"default"===e||Object.prototype.hasOwnProperty.call(exports,e)||Object.defineProperty(exports,e,{enumerable:!0,get:()=>l[e]})}));
+//# sourceMappingURL=index.cjs.map

package/dist/vue/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/vue/hooks/use-thumbnail.ts","../../src/vue/components/thumbnails-pane.vue","../../src/vue/components/thumbnail-img.vue"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/vue';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","<script setup lang=\"ts\">\nimport { onMounted, onBeforeUnmount, ref, watchEffect, nextTick, useAttrs } from 'vue';\nimport { useThumbnailPlugin } from '../hooks';\nimport type { WindowState } from '@embedpdf/plugin-thumbnail';\n\nconst attrs = useAttrs();\n\nconst { plugin: thumbnailPlugin } = useThumbnailPlugin();\nconst viewportRef = ref<HTMLDivElement | null>(null);\nconst windowState = ref<WindowState | null>(null);\n\nlet offWindow: (() => void) | null = null;\nlet offScrollTo: (() => void) | null = null;\n\nwatchEffect((onCleanup) => {\n  if (!thumbnailPlugin.value) return;\n  offWindow?.();\n  offWindow = thumbnailPlugin.value.onWindow((w) => (windowState.value = w));\n  onCleanup(() => offWindow?.());\n});\n\n// Setup scroll listener on mount\nonMounted(() => {\n  const vp = viewportRef.value;\n  if (!vp || !thumbnailPlugin.value) return;\n\n  const onScroll = () => thumbnailPlugin.value!.updateWindow(vp.scrollTop, vp.clientHeight);\n  vp.addEventListener('scroll', onScroll);\n\n  // initial push\n  thumbnailPlugin.value.updateWindow(vp.scrollTop, vp.clientHeight);\n\n  onBeforeUnmount(() => {\n    vp.removeEventListener('scroll', onScroll);\n  });\n});\n\n// Setup scrollTo subscription only after window is ready\nwatchEffect((onCleanup) => {\n  const vp = viewportRef.value;\n  if (!vp || !thumbnailPlugin.value || !windowState.value) return;\n\n  offScrollTo = thumbnailPlugin.value.onScrollTo(({ top, behavior }) => {\n    // Wait for Vue to finish rendering the content before scrolling\n    nextTick(() => {\n      vp.scrollTo({ top, behavior });\n    });\n  });\n\n  onCleanup(() => offScrollTo?.());\n});\n\nonBeforeUnmount(() => {\n  offWindow?.();\n  offScrollTo?.();\n});\n</script>\n\n<template>\n  <div ref=\"viewportRef\" :style=\"{ overflowY: 'auto', position: 'relative' }\" v-bind=\"attrs\">\n    <div :style=\"{ height: (windowState?.totalHeight ?? 0) + 'px', position: 'relative' }\">\n      <!-- ✅ Use a template v-for to render the default scoped slot -->\n      <template v-for=\"m in windowState?.items ?? []\" :key=\"m.pageIndex\">\n        <slot :meta=\"m\" />\n      </template>\n    </div>\n  </div>\n</template>\n","<script setup lang=\"ts\">\nimport { onBeforeUnmount, ref, watch, watchEffect, useAttrs } from 'vue';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\nimport type { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\n\nconst props = defineProps<{ meta: ThumbMeta }>();\nconst attrs = useAttrs();\n\nconst { provides: thumbs } = useThumbnailCapability();\nconst { plugin: thumbnailPlugin } = useThumbnailPlugin();\n\nconst url = ref<string | null>(null);\nlet urlToRevoke: string | null = null;\nconst refreshTick = ref(0);\n\nlet offRefresh: (() => void) | null = null;\n\nwatchEffect((onCleanup) => {\n  if (!thumbnailPlugin.value) return;\n  offRefresh?.();\n  offRefresh = thumbnailPlugin.value.onRefreshPages((pages) => {\n    if (pages.includes(props.meta.pageIndex)) {\n      refreshTick.value++;\n    }\n  });\n  onCleanup(() => offRefresh?.());\n});\n\nfunction revoke() {\n  if (urlToRevoke) {\n    URL.revokeObjectURL(urlToRevoke);\n    urlToRevoke = null;\n  }\n}\n\nlet abortTask: (() => void) | null = null;\n\nfunction load() {\n  if (!thumbs.value) return; // wait until capability exists\n\n  const task = thumbs.value.renderThumb(props.meta.pageIndex, window.devicePixelRatio);\n  abortTask = () =>\n    task.abort({\n      code: PdfErrorCode.Cancelled,\n      message: 'canceled render task',\n    });\n\n  task.wait((blob) => {\n    revoke();\n    const objectUrl = URL.createObjectURL(blob);\n    urlToRevoke = objectUrl;\n    url.value = objectUrl;\n  }, ignore);\n}\n\n/* 🔧 Re-run when:\n   - page changes,\n   - the plugin tells us to refresh,\n   - OR the capability becomes available later.\n*/\nwatch(\n  () => [props.meta.pageIndex, refreshTick.value, !!thumbs.value],\n  () => {\n    abortTask?.();\n    load();\n  },\n  { immediate: true },\n);\n\nonBeforeUnmount(() => {\n  abortTask?.();\n  revoke();\n});\n</script>\n\n<template>\n  <img v-if=\"url\" :src=\"url\" v-bind=\"attrs\" @load=\"revoke\" />\n</template>\n"],"names":["useThumbnailPlugin","usePlugin","ThumbnailPlugin","id","useThumbnailCapability","useCapability","attrs","useAttrs","plugin","thumbnailPlugin","viewportRef","ref","windowState","offWindow","offScrollTo","vue$1","watchEffect","onCleanup","value","onWindow","w","onMounted","vp","onScroll","updateWindow","scrollTop","clientHeight","addEventListener","onBeforeUnmount","removeEventListener","onScrollTo","top","behavior","nextTick","scrollTo","_openBlock","_createElementBlock","_mergeProps","style","overflowY","position","_unref","unref","_createElementVNode","_normalizeStyle","normalizeStyle","height","_a","totalHeight","createElementBlock","_Fragment","Fragment","_renderList","_b","items","m","_renderSlot","_ctx","$slots","key","pageIndex","meta","props","__props","provides","thumbs","url","urlToRevoke","refreshTick","offRefresh","revoke","URL","revokeObjectURL","onRefreshPages","pages","includes","abortTask","watch","task","renderThumb","window","devicePixelRatio","abort","code","PdfErrorCode","Cancelled","message","wait","blob","objectUrl","createObjectURL","ignore","load","immediate","src","onLoad","_hoisted_1"],"mappings":"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"}

package/dist/vue/index.d.ts

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './components';
+export * from '../lib/index.ts';

package/dist/vue/index.js

@@ -0,0 +1,140 @@
+import { usePlugin, useCapability } from "@embedpdf/core/vue";
+import { ThumbnailPlugin } from "@embedpdf/plugin-thumbnail";
+export * from "@embedpdf/plugin-thumbnail";
+import { defineComponent, useAttrs, ref, watchEffect, onMounted, onBeforeUnmount, nextTick, createElementBlock, openBlock, mergeProps, unref, createElementVNode, normalizeStyle, Fragment, renderList, renderSlot, watch, createCommentVNode } from "vue";
+import { ignore, PdfErrorCode } from "@embedpdf/models";
+const useThumbnailPlugin = () => usePlugin(ThumbnailPlugin.id);
+const useThumbnailCapability = () => useCapability(ThumbnailPlugin.id);
+const _sfc_main$1 = /* @__PURE__ */ defineComponent({
+  __name: "thumbnails-pane",
+  setup(__props) {
+    const attrs = useAttrs();
+    const { plugin: thumbnailPlugin } = useThumbnailPlugin();
+    const viewportRef = ref(null);
+    const windowState = ref(null);
+    let offWindow = null;
+    let offScrollTo = null;
+    watchEffect((onCleanup) => {
+      if (!thumbnailPlugin.value) return;
+      offWindow == null ? void 0 : offWindow();
+      offWindow = thumbnailPlugin.value.onWindow((w) => windowState.value = w);
+      onCleanup(() => offWindow == null ? void 0 : offWindow());
+    });
+    onMounted(() => {
+      const vp = viewportRef.value;
+      if (!vp || !thumbnailPlugin.value) return;
+      const onScroll = () => thumbnailPlugin.value.updateWindow(vp.scrollTop, vp.clientHeight);
+      vp.addEventListener("scroll", onScroll);
+      thumbnailPlugin.value.updateWindow(vp.scrollTop, vp.clientHeight);
+      onBeforeUnmount(() => {
+        vp.removeEventListener("scroll", onScroll);
+      });
+    });
+    watchEffect((onCleanup) => {
+      const vp = viewportRef.value;
+      if (!vp || !thumbnailPlugin.value || !windowState.value) return;
+      offScrollTo = thumbnailPlugin.value.onScrollTo(({ top, behavior }) => {
+        nextTick(() => {
+          vp.scrollTo({ top, behavior });
+        });
+      });
+      onCleanup(() => offScrollTo == null ? void 0 : offScrollTo());
+    });
+    onBeforeUnmount(() => {
+      offWindow == null ? void 0 : offWindow();
+      offScrollTo == null ? void 0 : offScrollTo();
+    });
+    return (_ctx, _cache) => {
+      var _a, _b;
+      return openBlock(), createElementBlock("div", mergeProps({
+        ref_key: "viewportRef",
+        ref: viewportRef,
+        style: { overflowY: "auto", position: "relative" }
+      }, unref(attrs)), [
+        createElementVNode("div", {
+          style: normalizeStyle({ height: (((_a = windowState.value) == null ? void 0 : _a.totalHeight) ?? 0) + "px", position: "relative" })
+        }, [
+          (openBlock(true), createElementBlock(Fragment, null, renderList(((_b = windowState.value) == null ? void 0 : _b.items) ?? [], (m) => {
+            return renderSlot(_ctx.$slots, "default", {
+              key: m.pageIndex,
+              meta: m
+            });
+          }), 128))
+        ], 4)
+      ], 16);
+    };
+  }
+});
+const _hoisted_1 = ["src"];
+const _sfc_main = /* @__PURE__ */ defineComponent({
+  __name: "thumbnail-img",
+  props: {
+    meta: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const attrs = useAttrs();
+    const { provides: thumbs } = useThumbnailCapability();
+    const { plugin: thumbnailPlugin } = useThumbnailPlugin();
+    const url = ref(null);
+    let urlToRevoke = null;
+    const refreshTick = ref(0);
+    let offRefresh = null;
+    watchEffect((onCleanup) => {
+      if (!thumbnailPlugin.value) return;
+      offRefresh == null ? void 0 : offRefresh();
+      offRefresh = thumbnailPlugin.value.onRefreshPages((pages) => {
+        if (pages.includes(props.meta.pageIndex)) {
+          refreshTick.value++;
+        }
+      });
+      onCleanup(() => offRefresh == null ? void 0 : offRefresh());
+    });
+    function revoke() {
+      if (urlToRevoke) {
+        URL.revokeObjectURL(urlToRevoke);
+        urlToRevoke = null;
+      }
+    }
+    let abortTask = null;
+    function load() {
+      if (!thumbs.value) return;
+      const task = thumbs.value.renderThumb(props.meta.pageIndex, window.devicePixelRatio);
+      abortTask = () => task.abort({
+        code: PdfErrorCode.Cancelled,
+        message: "canceled render task"
+      });
+      task.wait((blob) => {
+        revoke();
+        const objectUrl = URL.createObjectURL(blob);
+        urlToRevoke = objectUrl;
+        url.value = objectUrl;
+      }, ignore);
+    }
+    watch(
+      () => [props.meta.pageIndex, refreshTick.value, !!thumbs.value],
+      () => {
+        abortTask == null ? void 0 : abortTask();
+        load();
+      },
+      { immediate: true }
+    );
+    onBeforeUnmount(() => {
+      abortTask == null ? void 0 : abortTask();
+      revoke();
+    });
+    return (_ctx, _cache) => {
+      return url.value ? (openBlock(), createElementBlock("img", mergeProps({
+        key: 0,
+        src: url.value
+      }, unref(attrs), { onLoad: revoke }), null, 16, _hoisted_1)) : createCommentVNode("", true);
+    };
+  }
+});
+export {
+  _sfc_main as ThumbImg,
+  _sfc_main$1 as ThumbnailsPane,
+  useThumbnailCapability,
+  useThumbnailPlugin
+};
+//# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/vue/hooks/use-thumbnail.ts","../../src/vue/components/thumbnails-pane.vue","../../src/vue/components/thumbnail-img.vue"],"sourcesContent":["import { useCapability, usePlugin } from '@embedpdf/core/vue';\nimport { ThumbnailPlugin } from '@embedpdf/plugin-thumbnail';\n\nexport const useThumbnailPlugin = () => usePlugin<ThumbnailPlugin>(ThumbnailPlugin.id);\nexport const useThumbnailCapability = () => useCapability<ThumbnailPlugin>(ThumbnailPlugin.id);\n","<script setup lang=\"ts\">\nimport { onMounted, onBeforeUnmount, ref, watchEffect, nextTick, useAttrs } from 'vue';\nimport { useThumbnailPlugin } from '../hooks';\nimport type { WindowState } from '@embedpdf/plugin-thumbnail';\n\nconst attrs = useAttrs();\n\nconst { plugin: thumbnailPlugin } = useThumbnailPlugin();\nconst viewportRef = ref<HTMLDivElement | null>(null);\nconst windowState = ref<WindowState | null>(null);\n\nlet offWindow: (() => void) | null = null;\nlet offScrollTo: (() => void) | null = null;\n\nwatchEffect((onCleanup) => {\n  if (!thumbnailPlugin.value) return;\n  offWindow?.();\n  offWindow = thumbnailPlugin.value.onWindow((w) => (windowState.value = w));\n  onCleanup(() => offWindow?.());\n});\n\n// Setup scroll listener on mount\nonMounted(() => {\n  const vp = viewportRef.value;\n  if (!vp || !thumbnailPlugin.value) return;\n\n  const onScroll = () => thumbnailPlugin.value!.updateWindow(vp.scrollTop, vp.clientHeight);\n  vp.addEventListener('scroll', onScroll);\n\n  // initial push\n  thumbnailPlugin.value.updateWindow(vp.scrollTop, vp.clientHeight);\n\n  onBeforeUnmount(() => {\n    vp.removeEventListener('scroll', onScroll);\n  });\n});\n\n// Setup scrollTo subscription only after window is ready\nwatchEffect((onCleanup) => {\n  const vp = viewportRef.value;\n  if (!vp || !thumbnailPlugin.value || !windowState.value) return;\n\n  offScrollTo = thumbnailPlugin.value.onScrollTo(({ top, behavior }) => {\n    // Wait for Vue to finish rendering the content before scrolling\n    nextTick(() => {\n      vp.scrollTo({ top, behavior });\n    });\n  });\n\n  onCleanup(() => offScrollTo?.());\n});\n\nonBeforeUnmount(() => {\n  offWindow?.();\n  offScrollTo?.();\n});\n</script>\n\n<template>\n  <div ref=\"viewportRef\" :style=\"{ overflowY: 'auto', position: 'relative' }\" v-bind=\"attrs\">\n    <div :style=\"{ height: (windowState?.totalHeight ?? 0) + 'px', position: 'relative' }\">\n      <!-- ✅ Use a template v-for to render the default scoped slot -->\n      <template v-for=\"m in windowState?.items ?? []\" :key=\"m.pageIndex\">\n        <slot :meta=\"m\" />\n      </template>\n    </div>\n  </div>\n</template>\n","<script setup lang=\"ts\">\nimport { onBeforeUnmount, ref, watch, watchEffect, useAttrs } from 'vue';\nimport { useThumbnailCapability, useThumbnailPlugin } from '../hooks';\nimport type { ThumbMeta } from '@embedpdf/plugin-thumbnail';\nimport { ignore, PdfErrorCode } from '@embedpdf/models';\n\nconst props = defineProps<{ meta: ThumbMeta }>();\nconst attrs = useAttrs();\n\nconst { provides: thumbs } = useThumbnailCapability();\nconst { plugin: thumbnailPlugin } = useThumbnailPlugin();\n\nconst url = ref<string | null>(null);\nlet urlToRevoke: string | null = null;\nconst refreshTick = ref(0);\n\nlet offRefresh: (() => void) | null = null;\n\nwatchEffect((onCleanup) => {\n  if (!thumbnailPlugin.value) return;\n  offRefresh?.();\n  offRefresh = thumbnailPlugin.value.onRefreshPages((pages) => {\n    if (pages.includes(props.meta.pageIndex)) {\n      refreshTick.value++;\n    }\n  });\n  onCleanup(() => offRefresh?.());\n});\n\nfunction revoke() {\n  if (urlToRevoke) {\n    URL.revokeObjectURL(urlToRevoke);\n    urlToRevoke = null;\n  }\n}\n\nlet abortTask: (() => void) | null = null;\n\nfunction load() {\n  if (!thumbs.value) return; // wait until capability exists\n\n  const task = thumbs.value.renderThumb(props.meta.pageIndex, window.devicePixelRatio);\n  abortTask = () =>\n    task.abort({\n      code: PdfErrorCode.Cancelled,\n      message: 'canceled render task',\n    });\n\n  task.wait((blob) => {\n    revoke();\n    const objectUrl = URL.createObjectURL(blob);\n    urlToRevoke = objectUrl;\n    url.value = objectUrl;\n  }, ignore);\n}\n\n/* 🔧 Re-run when:\n   - page changes,\n   - the plugin tells us to refresh,\n   - OR the capability becomes available later.\n*/\nwatch(\n  () => [props.meta.pageIndex, refreshTick.value, !!thumbs.value],\n  () => {\n    abortTask?.();\n    load();\n  },\n  { immediate: true },\n);\n\nonBeforeUnmount(() => {\n  abortTask?.();\n  revoke();\n});\n</script>\n\n<template>\n  <img v-if=\"url\" :src=\"url\" v-bind=\"attrs\" @load=\"revoke\" />\n</template>\n"],"names":["_openBlock","_createElementBlock","_mergeProps","_unref","_createElementVNode","_normalizeStyle","_Fragment","_renderList","_renderSlot"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/plugin-thumbnail",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.cjs",
@@ -21,24 +21,31 @@
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js",
       "require": "./dist/react/index.cjs"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "import": "./dist/vue/index.js",
+      "require": "./dist/vue/index.cjs"
     }
   },
   "dependencies": {
-    "@embedpdf/models": "1.3.3"
+    "@embedpdf/models": "1.3.5"
   },
   "devDependencies": {
     "@types/react": "^18.2.0",
     "typescript": "^5.0.0",
     "@embedpdf/build": "1.0.1",
-    "@embedpdf/core": "1.3.3",
-    "@embedpdf/plugin-render": "1.3.3"
+    "@embedpdf/plugin-scroll": "1.3.5",
+    "@embedpdf/core": "1.3.5",
+    "@embedpdf/plugin-render": "1.3.5"
   },
   "peerDependencies": {
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0",
     "preact": "^10.26.4",
-    "@embedpdf/core": "1.3.3",
-    "@embedpdf/plugin-render": "1.3.3"
+    "vue": ">=3.2.0",
+    "@embedpdf/core": "1.3.5",
+    "@embedpdf/plugin-render": "1.3.5"
   },
   "files": [
     "dist",
@@ -60,7 +67,8 @@
     "build:base": "vite build --mode base",
     "build:react": "vite build --mode react",
     "build:preact": "vite build --mode preact",
-    "build": "pnpm run clean && concurrently -c auto -n base,react,preact \"vite build --mode base\" \"vite build --mode react\" \"vite build --mode preact\"",
+    "build:vue": "vite build --mode vue",
+    "build": "pnpm run clean && concurrently -c auto -n base,react,preact,vue \"vite build --mode base\" \"vite build --mode react\" \"vite build --mode preact\" \"vite build --mode vue\"",
     "clean": "rimraf dist",
     "lint": "eslint src --color",
     "lint:fix": "eslint src --color --fix"