@lancercomet/zoom-pan 0.1.1 → 0.1.3

package/dist/core/view-manager.d.ts

@@ -0,0 +1,212 @@
+import type { LayerManagerBase } from '../layer/layer-manager.base';
+import type { Plugin } from '../plugins/types';
+type RenderFn = (view: ViewManager) => void;
+type UpdateCallback = (dt: number) => void;
+type RenderCallback = (ctx: CanvasRenderingContext2D) => void;
+interface ViewManagerOption {
+    minZoom?: number;
+    maxZoom?: number;
+    approachKZoom?: number;
+    approachKPan?: number;
+    autoResize?: boolean;
+    background?: string | null;
+}
+declare class ViewManager {
+    readonly canvas: HTMLCanvasElement;
+    readonly context: CanvasRenderingContext2D;
+    readonly contentCanvas: HTMLCanvasElement;
+    readonly contentContext: CanvasRenderingContext2D;
+    readonly topScreenCanvas: HTMLCanvasElement;
+    readonly topScreenContext: CanvasRenderingContext2D;
+    private readonly _render;
+    private readonly _options;
+    private readonly _resizeObserver?;
+    private _layerManagers;
+    private _plugins;
+    private _isResetting;
+    private _isResizing;
+    private _resizeReleaseTimer;
+    private _needsRender;
+    private _raf;
+    private _lastFrameTs;
+    private _tx;
+    private _ty;
+    private _anchorX;
+    private _anchorY;
+    private _currentLogZ;
+    private _targetLogZ;
+    private LOG_MIN;
+    private LOG_MAX;
+    private _updateCallbacks;
+    private _beforeRenderCallbacks;
+    private _afterRenderCallbacks;
+    get zoom(): number;
+    get minZoom(): number;
+    get maxZoom(): number;
+    private _dpr;
+    get dpr(): number;
+    /**
+     * Install a plugin.
+     */
+    use<T extends Plugin>(plugin: T): T;
+    /**
+     * Uninstall a plugin by name.
+     */
+    unuse(name: string): void;
+    /**
+     * Get an installed plugin by name.
+     */
+    getPlugin<T extends Plugin>(name: string): T | undefined;
+    /**
+     * Register a callback to be called every frame with delta time.
+     */
+    onUpdate(callback: UpdateCallback): void;
+    /**
+     * Unregister an update callback.
+     */
+    offUpdate(callback: UpdateCallback): void;
+    /**
+     * Register a callback to be called before rendering (with world transform applied).
+     */
+    onBeforeRender(callback: RenderCallback): void;
+    /**
+     * Unregister a before-render callback.
+     */
+    offBeforeRender(callback: RenderCallback): void;
+    /**
+     * Register a callback to be called after rendering.
+     */
+    onAfterRender(callback: RenderCallback): void;
+    /**
+     * Unregister an after-render callback.
+     */
+    offAfterRender(callback: RenderCallback): void;
+    /**
+     * Request a render on the next frame.
+     * Call this when content changes and needs to be redrawn.
+     */
+    requestRender(): void;
+    /**
+     * Clamp target zoom (log space) to range.
+     */
+    private _clampLog;
+    /**
+     * Set target zoom at screen anchor point, with smooth transition.
+     */
+    private _setTargetLogZoomAtScreen;
+    /**
+     * Zoom to absolute zoom level at screen point, with smooth transition.
+     */
+    zoomToAtScreen(anchorX: number, anchorY: number, zoom: number): void;
+    /**
+     * Zoom to absolute zoom level at screen point, instantly (no animation).
+     */
+    zoomToAtScreenRaw(anchorX: number, anchorY: number, zoom: number): void;
+    /**
+     * Zoom to absolute zoom level at world point, with smooth transition.
+     */
+    zoomToAtWorld(wx: number, wy: number, zoom: number): void;
+    /**
+     * Zoom by multiplicative factor at screen point, with smooth transition.
+     */
+    zoomByFactorAtScreen(anchorX: number, anchorY: number, factor: number): void;
+    /**
+     * Zoom by log step at screen point. Used by interaction plugin.
+     */
+    zoomByLogAtScreen(anchorX: number, anchorY: number, stepLog: number): void;
+    /**
+     * Zoom by multiplicative factor at world point, with smooth transition.
+     */
+    zoomByFactorAtWorld(wx: number, wy: number, factor: number): void;
+    /**
+     * Pan by delta (CSS px).
+     */
+    panBy(dx: number, dy: number): void;
+    /**
+     * Set pan position (CSS px).
+     */
+    setPan(tx: number, ty: number): void;
+    /**
+     * Set full transform: zoom and pan.
+     */
+    setTransform(zoom: number, tx: number, ty: number): void;
+    private _ensureOffscreenSizeLike;
+    private _loop;
+    applyWorldTransform(ctx: CanvasRenderingContext2D): void;
+    applyScreenTransform(ctx: CanvasRenderingContext2D): void;
+    getPixelColorAtScreen(sx: number, sy: number): {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+        rgba: string;
+        hex: string;
+    };
+    getPixelColorAtWorld(wx: number, wy: number): {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+        rgba: string;
+        hex: string;
+    };
+    registerLayerManager(manager: LayerManagerBase): void;
+    unregisterLayerManager(manager: LayerManagerBase): void;
+    getLayerManagers(): LayerManagerBase[];
+    /**
+     * Smoothly reset to zoom=1, pan=(0,0).
+     */
+    resetSmooth(): void;
+    /**
+     * Instantly reset (no animation).
+     */
+    resetInstant(): void;
+    /**
+     * Convert screen (canvas client) -> world.
+     */
+    toWorld(x: number, y: number): {
+        wx: number;
+        wy: number;
+    };
+    /**
+     * Convert world -> screen (canvas client).
+     */
+    toScreen(wx: number, wy: number): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Get current transform.
+     */
+    getTransform(): {
+        zoom: number;
+        tx: number;
+        ty: number;
+    };
+    /**
+     * Get viewport bounds in world coordinates.
+     */
+    getViewportBounds(): {
+        left: number;
+        top: number;
+        right: number;
+        bottom: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * Set zoom range.
+     */
+    setZoomRange(minZoom: number, maxZoom: number): void;
+    /**
+     * Resize canvas to match parent size and DPR.
+     */
+    resizeToParent(): void;
+    /**
+     * Destroy and cleanup.
+     */
+    destroy(): void;
+    constructor(canvas: HTMLCanvasElement, render: RenderFn, options?: ViewManagerOption);
+}
+export { ViewManager };
+export type { ViewManagerOption, RenderFn, UpdateCallback, RenderCallback };