@lancercomet/zoom-pan 0.1.1 → 0.1.3

package/dist/plugins/history/snapshot-command.d.ts

@@ -0,0 +1,68 @@
+import type { ICommand } from './types';
+/**
+ * Interface for objects that can capture and restore snapshots.
+ * CanvasLayer implements this interface.
+ */
+interface ISnapshotable {
+    captureSnapshot(region?: ISnapshotRegion): ImageData | null;
+    restoreSnapshot(data: ImageData, position?: {
+        x: number;
+        y: number;
+    }): void;
+}
+interface ISnapshotRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface SnapshotCommandOptions {
+    /**
+     * The region of the snapshot. If not provided, uses full canvas.
+     */
+    region?: ISnapshotRegion;
+}
+/**
+ * A generic command that stores before/after snapshots for undo/redo.
+ * This command is decoupled from any specific layer implementation.
+ */
+declare class SnapshotCommand implements ICommand {
+    readonly type = "snapshot";
+    private readonly _target;
+    private readonly _beforeData;
+    private readonly _afterData;
+    private readonly _region?;
+    private _isExecuted;
+    /**
+     * Create a snapshot command.
+     *
+     * @param target - The object to restore snapshots to (must implement ISnapshotable)
+     * @param beforeData - The snapshot before the change
+     * @param afterData - The snapshot after the change
+     * @param options - Optional configuration
+     */
+    constructor(target: ISnapshotable, beforeData: ImageData, afterData: ImageData, options?: SnapshotCommandOptions);
+    execute(): void;
+    undo(): void;
+    canMerge(): boolean;
+    merge(): ICommand;
+}
+/**
+ * Helper function to create a snapshot command.
+ *
+ * Usage:
+ * ```typescript
+ * // Before starting the action
+ * const before = layer.captureSnapshot()
+ *
+ * // ... perform some drawing ...
+ *
+ * // After the action is complete
+ * const after = layer.captureSnapshot()
+ * const command = createSnapshotCommand(layer, before, after)
+ * historyManager.addCommand(command)
+ * ```
+ */
+declare function createSnapshotCommand(target: ISnapshotable, beforeData: ImageData | null, afterData: ImageData | null, options?: SnapshotCommandOptions): SnapshotCommand | null;
+export { SnapshotCommand, createSnapshotCommand };
+export type { ISnapshotable, ISnapshotRegion, SnapshotCommandOptions };

package/dist/plugins/history/types.d.ts

@@ -0,0 +1,9 @@
+type CommandType = 'snapshot' | string;
+interface ICommand {
+    readonly type: CommandType;
+    execute(): void;
+    undo(): void;
+    canMerge?(other: ICommand): boolean;
+    merge?(other: ICommand): ICommand;
+}
+export type { CommandType, ICommand };

package/dist/plugins/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './interaction';
+export * from './document';
+export * from './history';

package/dist/plugins/interaction/index.d.ts

@@ -0,0 +1,76 @@
+import type { ViewManager } from '../../core/view-manager';
+import type { Plugin } from '../types';
+interface InteractionPluginOptions {
+    /**
+     * Enable pan (drag to move). Default true.
+     */
+    panEnabled?: boolean;
+    /**
+     * Enable zoom (wheel to scale). Default true.
+     */
+    zoomEnabled?: boolean;
+    /**
+     * Friction for inertia (per frame). Default 0.92.
+     */
+    friction?: number;
+    /**
+     * Stop speed threshold (px/ms). Default 20/1000.
+     */
+    stopSpeed?: number;
+    /**
+     * EMA alpha for velocity smoothing. Default 0.25.
+     */
+    emaAlpha?: number;
+    /**
+     * Idle time (ms) before clearing inertia on pointer up. Default 120.
+     */
+    idleNoInertiaMs?: number;
+    /**
+     * Wheel sensitivity (pixel -> log step multiplier). Default 0.0015.
+     */
+    wheelSensitivity?: number;
+}
+/**
+ * Interaction Plugin
+ *
+ * Handles pan (drag), zoom (wheel), and inertia.
+ * Can be enabled/disabled at runtime.
+ */
+declare class InteractionPlugin implements Plugin {
+    readonly name = "interaction";
+    private _view;
+    private _options;
+    private _panEnabled;
+    private _zoomEnabled;
+    private _dragging;
+    private _vx;
+    private _vy;
+    private _lastMoveTs;
+    private _activePointerId;
+    private _onDownBound;
+    private _onMoveBound;
+    private _onUpBound;
+    private _onWheelBound;
+    constructor(options?: InteractionPluginOptions);
+    install(view: ViewManager): void;
+    destroy(): void;
+    isPanEnabled(): boolean;
+    isZoomEnabled(): boolean;
+    setPanEnabled(enabled: boolean): void;
+    setZoomEnabled(enabled: boolean): void;
+    setWheelSensitivity(s: number): void;
+    isDragging(): boolean;
+    private _onUpdate;
+    private _onPointerDown;
+    private _onPointerMove;
+    private _onPointerUp;
+    private _getLineHeightPx;
+    private _normalizeWheelDelta;
+    private _onWheel;
+}
+/**
+ * Create an interaction plugin instance.
+ */
+declare function createInteractionPlugin(options?: InteractionPluginOptions): InteractionPlugin;
+export { InteractionPlugin, createInteractionPlugin };
+export type { InteractionPluginOptions };

package/dist/plugins/types.d.ts

@@ -0,0 +1,29 @@
+import type { ViewManager } from '../core/view-manager';
+/**
+ * Plugin interface for ViewManager.
+ * Plugins can extend the core functionality with additional features.
+ */
+interface Plugin {
+    /**
+     * Unique name of the plugin.
+     */
+    readonly name: string;
+    /**
+     * Called when the plugin is installed on a ViewManager instance.
+     * @param view The ViewManager instance
+     */
+    install(view: ViewManager): void;
+    /**
+     * Called when the plugin is uninstalled or the ViewManager is destroyed.
+     */
+    destroy(): void;
+}
+/**
+ * Plugin constructor type for creating plugin instances.
+ */
+type PluginConstructor<T extends Plugin = Plugin, O = unknown> = new (options?: O) => T;
+/**
+ * Plugin factory function type.
+ */
+type PluginFactory<T extends Plugin = Plugin, O = unknown> = (options?: O) => T;
+export type { Plugin, PluginConstructor, PluginFactory };

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+type AnchorType = 'topLeft' | 'center';
+type SpaceType = 'world' | 'screen';
+type BlendMode = GlobalCompositeOperation;
+export type { AnchorType, SpaceType, BlendMode };

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+declare const loadImage: (src: string | File | Blob, crossOrigin?: "" | "anonymous" | "use-credentials") => Promise<HTMLImageElement>;
+declare const clamp: (value: number, min: number, max: number) => number;
+export { clamp, loadImage };

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@lancercomet/zoom-pan",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Yet another web 2D rendering lib.",
-  "main": "./dist/index.umd.js",
-  "module": "./dist/index.mjs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.module.js",
   "files": [
     "dist/**/*",
     "README.md"
@@ -11,7 +11,7 @@
   "scripts": {
     "dev": "vite",
     "build:example": "vite build --mode example",
-    "build:lib": "vite build --mode lib"
+    "build:lib": "rollup -c"
   },
   "keywords": [],
   "author": "",
@@ -20,6 +20,10 @@
     "@lancercomet/eslint-config-eslint-rules": "^0.2.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@vitejs/plugin-vue-jsx": "^5.1.1",
+    "rollup": "^4.53.3",
+    "rollup-plugin-commonjs": "^10.1.0",
+    "rollup-plugin-delete": "^2.0.0",
+    "rollup-plugin-typescript2": "^0.31.2",
     "stylus": "^0.64.0",
     "terser": "^5.44.1",
     "typescript": "^5.9.2",