@embedpdf/plugin-viewport 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CloudPDF
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,246 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  VIEWPORT_PLUGIN_ID: () => VIEWPORT_PLUGIN_ID,
+  ViewportPlugin: () => ViewportPlugin,
+  ViewportPluginPackage: () => ViewportPluginPackage,
+  manifest: () => manifest
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/manifest.ts
+var VIEWPORT_PLUGIN_ID = "viewport";
+var manifest = {
+  id: VIEWPORT_PLUGIN_ID,
+  name: "Viewport Plugin",
+  version: "1.0.0",
+  provides: ["viewport"],
+  requires: [],
+  optional: [],
+  defaultConfig: {
+    enabled: true,
+    viewportGap: 10,
+    scrollEndDelay: 300
+  }
+};
+
+// src/lib/actions.ts
+var SET_VIEWPORT_METRICS = "SET_VIEWPORT_METRICS";
+var SET_VIEWPORT_SCROLL_METRICS = "SET_VIEWPORT_SCROLL_METRICS";
+var SET_VIEWPORT_GAP = "SET_VIEWPORT_GAP";
+var SET_SCROLL_ACTIVITY = "SET_SCROLL_ACTIVITY";
+function setViewportGap(viewportGap) {
+  return {
+    type: SET_VIEWPORT_GAP,
+    payload: viewportGap
+  };
+}
+function setViewportMetrics(viewportMetrics) {
+  return {
+    type: SET_VIEWPORT_METRICS,
+    payload: viewportMetrics
+  };
+}
+function setViewportScrollMetrics(scrollMetrics) {
+  return {
+    type: SET_VIEWPORT_SCROLL_METRICS,
+    payload: scrollMetrics
+  };
+}
+function setScrollActivity(isScrolling) {
+  return { type: SET_SCROLL_ACTIVITY, payload: isScrolling };
+}
+
+// src/lib/reducer.ts
+var initialState = {
+  viewportGap: 0,
+  viewportMetrics: {
+    width: 0,
+    height: 0,
+    scrollTop: 0,
+    scrollLeft: 0,
+    clientWidth: 0,
+    clientHeight: 0,
+    scrollWidth: 0,
+    scrollHeight: 0,
+    relativePosition: {
+      x: 0,
+      y: 0
+    }
+  },
+  isScrolling: false
+};
+var viewportReducer = (state = initialState, action) => {
+  switch (action.type) {
+    case SET_VIEWPORT_GAP:
+      return { ...state, viewportGap: action.payload };
+    case SET_VIEWPORT_METRICS:
+      return {
+        ...state,
+        viewportMetrics: {
+          width: action.payload.width,
+          height: action.payload.height,
+          scrollTop: action.payload.scrollTop,
+          scrollLeft: action.payload.scrollLeft,
+          clientWidth: action.payload.clientWidth,
+          clientHeight: action.payload.clientHeight,
+          scrollWidth: action.payload.scrollWidth,
+          scrollHeight: action.payload.scrollHeight,
+          relativePosition: {
+            x: action.payload.scrollWidth <= action.payload.clientWidth ? 0 : action.payload.scrollLeft / (action.payload.scrollWidth - action.payload.clientWidth),
+            y: action.payload.scrollHeight <= action.payload.clientHeight ? 0 : action.payload.scrollTop / (action.payload.scrollHeight - action.payload.clientHeight)
+          }
+        }
+      };
+    case SET_VIEWPORT_SCROLL_METRICS:
+      return {
+        ...state,
+        viewportMetrics: {
+          ...state.viewportMetrics,
+          scrollTop: action.payload.scrollTop,
+          scrollLeft: action.payload.scrollLeft
+        },
+        isScrolling: true
+      };
+    case SET_SCROLL_ACTIVITY:
+      return { ...state, isScrolling: action.payload };
+    default:
+      return state;
+  }
+};
+
+// src/lib/viewport-plugin.ts
+var import_core = require("@embedpdf/core");
+var ViewportPlugin = class extends import_core.BasePlugin {
+  constructor(id, registry, config) {
+    super(id, registry);
+    this.id = id;
+    this.viewportMetrics$ = (0, import_core.createBehaviorEmitter)();
+    this.scrollMetrics$ = (0, import_core.createBehaviorEmitter)();
+    this.scrollReq$ = (0, import_core.createEmitter)();
+    this.scrollActivity$ = (0, import_core.createBehaviorEmitter)();
+    /* ------------------------------------------------------------------ */
+    /* “live rect” infrastructure                                          */
+    /* ------------------------------------------------------------------ */
+    this.rectProvider = null;
+    if (config.viewportGap) {
+      this.dispatch(setViewportGap(config.viewportGap));
+    }
+    this.scrollEndDelay = config.scrollEndDelay || 300;
+  }
+  buildCapability() {
+    return {
+      getViewportGap: () => this.state.viewportGap,
+      getMetrics: () => this.state.viewportMetrics,
+      onScrollChange: this.scrollMetrics$.on,
+      onViewportChange: this.viewportMetrics$.on,
+      registerBoundingRectProvider: (fn) => {
+        this.rectProvider = fn;
+      },
+      getBoundingRect: () => this.rectProvider?.() ?? {
+        origin: { x: 0, y: 0 },
+        size: { width: 0, height: 0 }
+      },
+      setViewportMetrics: (viewportMetrics) => {
+        this.dispatch(setViewportMetrics(viewportMetrics));
+      },
+      setViewportScrollMetrics: this.setViewportScrollMetrics.bind(this),
+      scrollTo: (pos) => this.scrollTo(pos),
+      onScrollRequest: this.scrollReq$.on,
+      isScrolling: () => this.state.isScrolling,
+      onScrollActivity: this.scrollActivity$.on
+    };
+  }
+  bumpScrollActivity() {
+    if (this.scrollEndTimer) clearTimeout(this.scrollEndTimer);
+    this.scrollEndTimer = window.setTimeout(() => {
+      this.dispatch(setScrollActivity(false));
+      this.scrollEndTimer = void 0;
+    }, this.scrollEndDelay);
+  }
+  setViewportScrollMetrics(scrollMetrics) {
+    if (scrollMetrics.scrollTop !== this.state.viewportMetrics.scrollTop || scrollMetrics.scrollLeft !== this.state.viewportMetrics.scrollLeft) {
+      this.dispatch(setViewportScrollMetrics(scrollMetrics));
+      this.bumpScrollActivity();
+    }
+  }
+  scrollTo(pos) {
+    const { x, y, center, behavior = "auto" } = pos;
+    if (center) {
+      const metrics = this.state.viewportMetrics;
+      const centeredX = x - metrics.clientWidth / 2;
+      const centeredY = y - metrics.clientHeight / 2;
+      this.scrollReq$.emit({
+        x: centeredX,
+        y: centeredY,
+        behavior
+      });
+    } else {
+      this.scrollReq$.emit({
+        x,
+        y,
+        behavior
+      });
+    }
+  }
+  // Subscribe to store changes to notify onViewportChange
+  onStoreUpdated(prevState, newState) {
+    if (prevState !== newState) {
+      this.viewportMetrics$.emit(newState.viewportMetrics);
+      this.scrollMetrics$.emit({
+        scrollTop: newState.viewportMetrics.scrollTop,
+        scrollLeft: newState.viewportMetrics.scrollLeft
+      });
+      if (prevState.isScrolling !== newState.isScrolling) {
+        this.scrollActivity$.emit(newState.isScrolling);
+      }
+    }
+  }
+  async initialize(_config) {
+  }
+  async destroy() {
+    super.destroy();
+    this.viewportMetrics$.clear();
+    this.scrollMetrics$.clear();
+    this.scrollReq$.clear();
+    this.scrollActivity$.clear();
+    this.rectProvider = null;
+    if (this.scrollEndTimer) clearTimeout(this.scrollEndTimer);
+  }
+};
+ViewportPlugin.id = "viewport";
+
+// src/lib/index.ts
+var ViewportPluginPackage = {
+  manifest,
+  create: (registry, _engine, config) => new ViewportPlugin(VIEWPORT_PLUGIN_ID, registry, config),
+  reducer: viewportReducer,
+  initialState
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VIEWPORT_PLUGIN_ID,
+  ViewportPlugin,
+  ViewportPluginPackage,
+  manifest
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/lib/manifest.ts","../src/lib/actions.ts","../src/lib/reducer.ts","../src/lib/viewport-plugin.ts","../src/lib/index.ts"],"sourcesContent":["export * from './lib';\n","import { PluginManifest } from '@embedpdf/core';\n\nimport { ViewportPluginConfig } from './types';\n\nexport const VIEWPORT_PLUGIN_ID = 'viewport';\n\nexport const manifest: PluginManifest<ViewportPluginConfig> = {\n  id: VIEWPORT_PLUGIN_ID,\n  name: 'Viewport Plugin',\n  version: '1.0.0',\n  provides: ['viewport'],\n  requires: [],\n  optional: [],\n  defaultConfig: {\n    enabled: true,\n    viewportGap: 10,\n    scrollEndDelay: 300,\n  },\n};\n","import { Action } from '@embedpdf/core';\n\nimport { ViewportInputMetrics, ViewportScrollMetrics } from './types';\n\nexport const SET_VIEWPORT_METRICS = 'SET_VIEWPORT_METRICS';\nexport const SET_VIEWPORT_SCROLL_METRICS = 'SET_VIEWPORT_SCROLL_METRICS';\nexport const SET_VIEWPORT_GAP = 'SET_VIEWPORT_GAP';\nexport const SET_SCROLL_ACTIVITY = 'SET_SCROLL_ACTIVITY';\n\nexport interface SetViewportMetricsAction extends Action {\n  type: typeof SET_VIEWPORT_METRICS;\n  payload: ViewportInputMetrics;\n}\n\nexport interface SetViewportScrollMetricsAction extends Action {\n  type: typeof SET_VIEWPORT_SCROLL_METRICS;\n  payload: ViewportScrollMetrics;\n}\n\nexport interface SetViewportGapAction extends Action {\n  type: typeof SET_VIEWPORT_GAP;\n  payload: number;\n}\n\nexport interface SetScrollActivityAction extends Action {\n  type: typeof SET_SCROLL_ACTIVITY;\n  payload: boolean;\n}\n\nexport type ViewportAction =\n  | SetViewportMetricsAction\n  | SetViewportScrollMetricsAction\n  | SetViewportGapAction\n  | SetScrollActivityAction;\n\nexport function setViewportGap(viewportGap: number): SetViewportGapAction {\n  return {\n    type: SET_VIEWPORT_GAP,\n    payload: viewportGap,\n  };\n}\n\nexport function setViewportMetrics(\n  viewportMetrics: ViewportInputMetrics,\n): SetViewportMetricsAction {\n  return {\n    type: SET_VIEWPORT_METRICS,\n    payload: viewportMetrics,\n  };\n}\n\nexport function setViewportScrollMetrics(\n  scrollMetrics: ViewportScrollMetrics,\n): SetViewportScrollMetricsAction {\n  return {\n    type: SET_VIEWPORT_SCROLL_METRICS,\n    payload: scrollMetrics,\n  };\n}\n\nexport function setScrollActivity(isScrolling: boolean): SetScrollActivityAction {\n  return { type: SET_SCROLL_ACTIVITY, payload: isScrolling };\n}\n","import { Reducer } from '@embedpdf/core';\n\nimport {\n  SET_VIEWPORT_METRICS,\n  SET_VIEWPORT_SCROLL_METRICS,\n  SET_VIEWPORT_GAP,\n  ViewportAction,\n  SET_SCROLL_ACTIVITY,\n} from './actions';\nimport { ViewportState } from './types';\n\nexport const initialState: ViewportState = {\n  viewportGap: 0,\n  viewportMetrics: {\n    width: 0,\n    height: 0,\n    scrollTop: 0,\n    scrollLeft: 0,\n    clientWidth: 0,\n    clientHeight: 0,\n    scrollWidth: 0,\n    scrollHeight: 0,\n    relativePosition: {\n      x: 0,\n      y: 0,\n    },\n  },\n  isScrolling: false,\n};\n\nexport const viewportReducer: Reducer<ViewportState, ViewportAction> = (\n  state = initialState,\n  action,\n) => {\n  switch (action.type) {\n    case SET_VIEWPORT_GAP:\n      return { ...state, viewportGap: action.payload };\n    case SET_VIEWPORT_METRICS:\n      return {\n        ...state,\n        viewportMetrics: {\n          width: action.payload.width,\n          height: action.payload.height,\n          scrollTop: action.payload.scrollTop,\n          scrollLeft: action.payload.scrollLeft,\n          clientWidth: action.payload.clientWidth,\n          clientHeight: action.payload.clientHeight,\n          scrollWidth: action.payload.scrollWidth,\n          scrollHeight: action.payload.scrollHeight,\n          relativePosition: {\n            x:\n              action.payload.scrollWidth <= action.payload.clientWidth\n                ? 0\n                : action.payload.scrollLeft /\n                  (action.payload.scrollWidth - action.payload.clientWidth),\n            y:\n              action.payload.scrollHeight <= action.payload.clientHeight\n                ? 0\n                : action.payload.scrollTop /\n                  (action.payload.scrollHeight - action.payload.clientHeight),\n          },\n        },\n      };\n    case SET_VIEWPORT_SCROLL_METRICS:\n      return {\n        ...state,\n        viewportMetrics: {\n          ...state.viewportMetrics,\n          scrollTop: action.payload.scrollTop,\n          scrollLeft: action.payload.scrollLeft,\n        },\n        isScrolling: true,\n      };\n    case SET_SCROLL_ACTIVITY:\n      return { ...state, isScrolling: action.payload };\n    default:\n      return state;\n  }\n};\n","import { BasePlugin, PluginRegistry, createEmitter, createBehaviorEmitter } from '@embedpdf/core';\n\nimport {\n  ViewportAction,\n  setViewportMetrics,\n  setViewportScrollMetrics,\n  setViewportGap,\n  setScrollActivity,\n} from './actions';\nimport {\n  ViewportPluginConfig,\n  ViewportState,\n  ViewportCapability,\n  ViewportMetrics,\n  ViewportScrollMetrics,\n  ViewportInputMetrics,\n  ScrollToPayload,\n} from './types';\nimport { Rect } from '@embedpdf/models';\n\nexport class ViewportPlugin extends BasePlugin<\n  ViewportPluginConfig,\n  ViewportCapability,\n  ViewportState,\n  ViewportAction\n> {\n  static readonly id = 'viewport' as const;\n\n  private readonly viewportMetrics$ = createBehaviorEmitter<ViewportMetrics>();\n  private readonly scrollMetrics$ = createBehaviorEmitter<ViewportScrollMetrics>();\n  private readonly scrollReq$ = createEmitter<{\n    x: number;\n    y: number;\n    behavior?: ScrollBehavior;\n  }>();\n  private readonly scrollActivity$ = createBehaviorEmitter<boolean>();\n\n  /* ------------------------------------------------------------------ */\n  /* “live rect” infrastructure                                          */\n  /* ------------------------------------------------------------------ */\n  private rectProvider: (() => Rect) | null = null;\n\n  private scrollEndTimer?: number;\n  private readonly scrollEndDelay: number;\n\n  constructor(\n    public readonly id: string,\n    registry: PluginRegistry,\n    config: ViewportPluginConfig,\n  ) {\n    super(id, registry);\n\n    if (config.viewportGap) {\n      this.dispatch(setViewportGap(config.viewportGap));\n    }\n\n    this.scrollEndDelay = config.scrollEndDelay || 300;\n  }\n\n  protected buildCapability(): ViewportCapability {\n    return {\n      getViewportGap: () => this.state.viewportGap,\n      getMetrics: () => this.state.viewportMetrics,\n      onScrollChange: this.scrollMetrics$.on,\n      onViewportChange: this.viewportMetrics$.on,\n      registerBoundingRectProvider: (fn) => {\n        this.rectProvider = fn;\n      },\n      getBoundingRect: (): Rect =>\n        this.rectProvider?.() ?? {\n          origin: { x: 0, y: 0 },\n          size: { width: 0, height: 0 },\n        },\n      setViewportMetrics: (viewportMetrics: ViewportInputMetrics) => {\n        this.dispatch(setViewportMetrics(viewportMetrics));\n      },\n      setViewportScrollMetrics: this.setViewportScrollMetrics.bind(this),\n      scrollTo: (pos: ScrollToPayload) => this.scrollTo(pos),\n      onScrollRequest: this.scrollReq$.on,\n      isScrolling: () => this.state.isScrolling,\n      onScrollActivity: this.scrollActivity$.on,\n    };\n  }\n\n  private bumpScrollActivity() {\n    if (this.scrollEndTimer) clearTimeout(this.scrollEndTimer);\n    this.scrollEndTimer = window.setTimeout(() => {\n      this.dispatch(setScrollActivity(false));\n      this.scrollEndTimer = undefined;\n    }, this.scrollEndDelay);\n  }\n\n  private setViewportScrollMetrics(scrollMetrics: ViewportScrollMetrics) {\n    if (\n      scrollMetrics.scrollTop !== this.state.viewportMetrics.scrollTop ||\n      scrollMetrics.scrollLeft !== this.state.viewportMetrics.scrollLeft\n    ) {\n      this.dispatch(setViewportScrollMetrics(scrollMetrics));\n      this.bumpScrollActivity();\n    }\n  }\n\n  private scrollTo(pos: ScrollToPayload) {\n    const { x, y, center, behavior = 'auto' } = pos;\n\n    if (center) {\n      const metrics = this.state.viewportMetrics;\n      // Calculate the centered position by adding half the viewport dimensions\n      const centeredX = x - metrics.clientWidth / 2;\n      const centeredY = y - metrics.clientHeight / 2;\n\n      this.scrollReq$.emit({\n        x: centeredX,\n        y: centeredY,\n        behavior,\n      });\n    } else {\n      this.scrollReq$.emit({\n        x,\n        y,\n        behavior,\n      });\n    }\n  }\n\n  // Subscribe to store changes to notify onViewportChange\n  override onStoreUpdated(prevState: ViewportState, newState: ViewportState): void {\n    if (prevState !== newState) {\n      this.viewportMetrics$.emit(newState.viewportMetrics);\n      this.scrollMetrics$.emit({\n        scrollTop: newState.viewportMetrics.scrollTop,\n        scrollLeft: newState.viewportMetrics.scrollLeft,\n      });\n      if (prevState.isScrolling !== newState.isScrolling) {\n        this.scrollActivity$.emit(newState.isScrolling);\n      }\n    }\n  }\n\n  async initialize(_config: ViewportPluginConfig) {\n    // No initialization needed\n  }\n\n  async destroy(): Promise<void> {\n    super.destroy();\n    // Clear out any handlers\n    this.viewportMetrics$.clear();\n    this.scrollMetrics$.clear();\n    this.scrollReq$.clear();\n    this.scrollActivity$.clear();\n    this.rectProvider = null;\n    if (this.scrollEndTimer) clearTimeout(this.scrollEndTimer);\n  }\n}\n","import { PluginPackage } from '@embedpdf/core';\n\nimport { ViewportAction } from './actions';\nimport { manifest, VIEWPORT_PLUGIN_ID } from './manifest';\nimport { viewportReducer, initialState } from './reducer';\nimport { ViewportPluginConfig, ViewportState } from './types';\nimport { ViewportPlugin } from './viewport-plugin';\n\nexport const ViewportPluginPackage: PluginPackage<\n  ViewportPlugin,\n  ViewportPluginConfig,\n  ViewportState,\n  ViewportAction\n> = {\n  manifest,\n  create: (registry, _engine, config) => new ViewportPlugin(VIEWPORT_PLUGIN_ID, registry, config),\n  reducer: viewportReducer,\n  initialState: initialState,\n};\n\nexport * from './viewport-plugin';\nexport * from './types';\nexport * from './manifest';\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,105 @@
+import { BasePluginConfig, EventControlOptions, EventHook, Action, BasePlugin, PluginRegistry, PluginManifest, PluginPackage } from '@embedpdf/core';
+import { Rect } from '@embedpdf/models';
+
+interface ViewportState {
+    viewportGap: number;
+    viewportMetrics: ViewportMetrics;
+    isScrolling: boolean;
+}
+interface ViewportPluginConfig extends BasePluginConfig {
+    viewportGap?: number;
+    scrollEndDelay?: number;
+}
+interface ViewportInputMetrics {
+    width: number;
+    height: number;
+    scrollTop: number;
+    scrollLeft: number;
+    clientWidth: number;
+    clientHeight: number;
+    scrollWidth: number;
+    scrollHeight: number;
+}
+interface ViewportMetrics extends ViewportInputMetrics {
+    relativePosition: {
+        x: number;
+        y: number;
+    };
+}
+interface ViewportScrollMetrics {
+    scrollTop: number;
+    scrollLeft: number;
+}
+interface ScrollControlOptions {
+    mode: 'debounce' | 'throttle';
+    wait: number;
+}
+interface ScrollToPayload {
+    x: number;
+    y: number;
+    behavior?: ScrollBehavior;
+    center?: boolean;
+}
+interface ViewportCapability {
+    getViewportGap: () => number;
+    getMetrics: () => ViewportMetrics;
+    setViewportMetrics: (metrics: ViewportInputMetrics) => void;
+    setViewportScrollMetrics: (metrics: ViewportScrollMetrics) => void;
+    onViewportChange: (handler: (metrics: ViewportMetrics) => void, options?: EventControlOptions) => (metrics: ViewportMetrics) => void;
+    scrollTo(position: ScrollToPayload): void;
+    onScrollRequest: EventHook<ScrollToPayload>;
+    onScrollChange: EventHook<ViewportScrollMetrics>;
+    onScrollActivity: EventHook<boolean>;
+    isScrolling: () => boolean;
+    getBoundingRect(): Rect;
+    registerBoundingRectProvider(fn: (() => Rect) | null): void;
+}
+
+declare const SET_VIEWPORT_METRICS = "SET_VIEWPORT_METRICS";
+declare const SET_VIEWPORT_SCROLL_METRICS = "SET_VIEWPORT_SCROLL_METRICS";
+declare const SET_VIEWPORT_GAP = "SET_VIEWPORT_GAP";
+declare const SET_SCROLL_ACTIVITY = "SET_SCROLL_ACTIVITY";
+interface SetViewportMetricsAction extends Action {
+    type: typeof SET_VIEWPORT_METRICS;
+    payload: ViewportInputMetrics;
+}
+interface SetViewportScrollMetricsAction extends Action {
+    type: typeof SET_VIEWPORT_SCROLL_METRICS;
+    payload: ViewportScrollMetrics;
+}
+interface SetViewportGapAction extends Action {
+    type: typeof SET_VIEWPORT_GAP;
+    payload: number;
+}
+interface SetScrollActivityAction extends Action {
+    type: typeof SET_SCROLL_ACTIVITY;
+    payload: boolean;
+}
+type ViewportAction = SetViewportMetricsAction | SetViewportScrollMetricsAction | SetViewportGapAction | SetScrollActivityAction;
+
+declare class ViewportPlugin extends BasePlugin<ViewportPluginConfig, ViewportCapability, ViewportState, ViewportAction> {
+    readonly id: string;
+    static readonly id: "viewport";
+    private readonly viewportMetrics$;
+    private readonly scrollMetrics$;
+    private readonly scrollReq$;
+    private readonly scrollActivity$;
+    private rectProvider;
+    private scrollEndTimer?;
+    private readonly scrollEndDelay;
+    constructor(id: string, registry: PluginRegistry, config: ViewportPluginConfig);
+    protected buildCapability(): ViewportCapability;
+    private bumpScrollActivity;
+    private setViewportScrollMetrics;
+    private scrollTo;
+    onStoreUpdated(prevState: ViewportState, newState: ViewportState): void;
+    initialize(_config: ViewportPluginConfig): Promise<void>;
+    destroy(): Promise<void>;
+}
+
+declare const VIEWPORT_PLUGIN_ID = "viewport";
+declare const manifest: PluginManifest<ViewportPluginConfig>;
+
+declare const ViewportPluginPackage: PluginPackage<ViewportPlugin, ViewportPluginConfig, ViewportState, ViewportAction>;
+
+export { type ScrollControlOptions, type ScrollToPayload, VIEWPORT_PLUGIN_ID, type ViewportCapability, type ViewportInputMetrics, type ViewportMetrics, ViewportPlugin, type ViewportPluginConfig, ViewportPluginPackage, type ViewportScrollMetrics, type ViewportState, manifest };

package/dist/index.d.ts

@@ -0,0 +1,105 @@
+import { BasePluginConfig, EventControlOptions, EventHook, Action, BasePlugin, PluginRegistry, PluginManifest, PluginPackage } from '@embedpdf/core';
+import { Rect } from '@embedpdf/models';
+
+interface ViewportState {
+    viewportGap: number;
+    viewportMetrics: ViewportMetrics;
+    isScrolling: boolean;
+}
+interface ViewportPluginConfig extends BasePluginConfig {
+    viewportGap?: number;
+    scrollEndDelay?: number;
+}
+interface ViewportInputMetrics {
+    width: number;
+    height: number;
+    scrollTop: number;
+    scrollLeft: number;
+    clientWidth: number;
+    clientHeight: number;
+    scrollWidth: number;
+    scrollHeight: number;
+}
+interface ViewportMetrics extends ViewportInputMetrics {
+    relativePosition: {
+        x: number;
+        y: number;
+    };
+}
+interface ViewportScrollMetrics {
+    scrollTop: number;
+    scrollLeft: number;
+}
+interface ScrollControlOptions {
+    mode: 'debounce' | 'throttle';
+    wait: number;
+}
+interface ScrollToPayload {
+    x: number;
+    y: number;
+    behavior?: ScrollBehavior;
+    center?: boolean;
+}
+interface ViewportCapability {
+    getViewportGap: () => number;
+    getMetrics: () => ViewportMetrics;
+    setViewportMetrics: (metrics: ViewportInputMetrics) => void;
+    setViewportScrollMetrics: (metrics: ViewportScrollMetrics) => void;
+    onViewportChange: (handler: (metrics: ViewportMetrics) => void, options?: EventControlOptions) => (metrics: ViewportMetrics) => void;
+    scrollTo(position: ScrollToPayload): void;
+    onScrollRequest: EventHook<ScrollToPayload>;
+    onScrollChange: EventHook<ViewportScrollMetrics>;
+    onScrollActivity: EventHook<boolean>;
+    isScrolling: () => boolean;
+    getBoundingRect(): Rect;
+    registerBoundingRectProvider(fn: (() => Rect) | null): void;
+}
+
+declare const SET_VIEWPORT_METRICS = "SET_VIEWPORT_METRICS";
+declare const SET_VIEWPORT_SCROLL_METRICS = "SET_VIEWPORT_SCROLL_METRICS";
+declare const SET_VIEWPORT_GAP = "SET_VIEWPORT_GAP";
+declare const SET_SCROLL_ACTIVITY = "SET_SCROLL_ACTIVITY";
+interface SetViewportMetricsAction extends Action {
+    type: typeof SET_VIEWPORT_METRICS;
+    payload: ViewportInputMetrics;
+}
+interface SetViewportScrollMetricsAction extends Action {
+    type: typeof SET_VIEWPORT_SCROLL_METRICS;
+    payload: ViewportScrollMetrics;
+}
+interface SetViewportGapAction extends Action {
+    type: typeof SET_VIEWPORT_GAP;
+    payload: number;
+}
+interface SetScrollActivityAction extends Action {
+    type: typeof SET_SCROLL_ACTIVITY;
+    payload: boolean;
+}
+type ViewportAction = SetViewportMetricsAction | SetViewportScrollMetricsAction | SetViewportGapAction | SetScrollActivityAction;
+
+declare class ViewportPlugin extends BasePlugin<ViewportPluginConfig, ViewportCapability, ViewportState, ViewportAction> {
+    readonly id: string;
+    static readonly id: "viewport";
+    private readonly viewportMetrics$;
+    private readonly scrollMetrics$;
+    private readonly scrollReq$;
+    private readonly scrollActivity$;
+    private rectProvider;
+    private scrollEndTimer?;
+    private readonly scrollEndDelay;
+    constructor(id: string, registry: PluginRegistry, config: ViewportPluginConfig);
+    protected buildCapability(): ViewportCapability;
+    private bumpScrollActivity;
+    private setViewportScrollMetrics;
+    private scrollTo;
+    onStoreUpdated(prevState: ViewportState, newState: ViewportState): void;
+    initialize(_config: ViewportPluginConfig): Promise<void>;
+    destroy(): Promise<void>;
+}
+
+declare const VIEWPORT_PLUGIN_ID = "viewport";
+declare const manifest: PluginManifest<ViewportPluginConfig>;
+
+declare const ViewportPluginPackage: PluginPackage<ViewportPlugin, ViewportPluginConfig, ViewportState, ViewportAction>;
+
+export { type ScrollControlOptions, type ScrollToPayload, VIEWPORT_PLUGIN_ID, type ViewportCapability, type ViewportInputMetrics, type ViewportMetrics, ViewportPlugin, type ViewportPluginConfig, ViewportPluginPackage, type ViewportScrollMetrics, type ViewportState, manifest };