@ue-too/board 0.14.1 → 0.16.0

package/camera/camera-rig/pan-handler.d.ts

@@ -1,5 +1,5 @@
-import { Point } from "@ue-too/math";
-import { BoardCamera } from "../interface";
+import { Point } from '@ue-too/math';
+import { BoardCamera } from '../interface';
 /**
  * Combined configuration for pan handler behavior, merging restriction and clamping settings.
  *

package/camera/camera-rig/rotation-handler.d.ts

@@ -1,4 +1,5 @@
-import { BoardCamera } from "../interface";
+import type { Point } from '@ue-too/math';
+import { BoardCamera } from '../interface';
 /**
  * Combined configuration for rotation handler behavior, merging restriction and clamping settings.
  *
@@ -166,6 +167,7 @@ export type RotateByHandlerFunction = (delta: number, camera: BoardCamera, confi
  * @see {@link createDefaultRotateToHandler} for the default implementation
  */
 export type RotateToHandlerFunction = (targetRotation: number, camera: BoardCamera, config: RotationHandlerConfig) => number;
+export type RotateToWithAnchorPointHandlerFunction = (targetRotation: number, anchorPoint: Point, camera: BoardCamera, config: RotationHandlerConfig) => number;
 /**
  * Handler pipeline step that clamps "rotate by" deltas to prevent angular boundary violations.
  *

package/camera/camera-rig/zoom-handler.d.ts

@@ -1,4 +1,4 @@
-import { BoardCamera } from "../interface";
+import { BoardCamera } from '../interface';
 /**
  * Combined configuration for zoom handler behavior, merging restriction and clamping settings.
  *

package/camera/default-camera.d.ts

@@ -1,12 +1,13 @@
 import { Point } from '@ue-too/math';
-import { Boundaries } from './utils/position';
-import { TransformationMatrix } from './utils/matrix';
+import { SubscriptionOptions } from '../utils/observable';
+import { CameraOptions } from './base';
+import { ObservableBoardCamera } from './interface';
 import { UnSubscribe } from './update-publisher';
-import { ZoomLevelLimits } from './utils/zoom';
-import { RotationLimits } from './utils/rotation';
 import { CameraEventMap, CameraState } from './update-publisher';
-import { ObservableBoardCamera } from './interface';
-import { SubscriptionOptions } from '../utils/observable';
+import { TransformationMatrix } from './utils/matrix';
+import { Boundaries } from './utils/position';
+import { RotationLimits } from './utils/rotation';
+import { ZoomLevelLimits } from './utils/zoom';
 /** Default viewport width in CSS pixels */
 export declare const DEFAULT_BOARD_CAMERA_VIEWPORT_WIDTH = 1000;
 /** Default viewport height in CSS pixels */
@@ -17,6 +18,7 @@ export declare const DEFAULT_BOARD_CAMERA_ZOOM_BOUNDARIES: ZoomLevelLimits;
 export declare const DEFAULT_BOARD_CAMERA_BOUNDARIES: Boundaries;
 /** Default rotation boundaries (unrestricted) */
 export declare const DEFAULT_BOARD_CAMERA_ROTATION_BOUNDARIES: RotationLimits | undefined;
+export declare const DEFAULT_BOARD_CAMERA_OPTIONS: CameraOptions;
 /**
  * Observable camera implementation that extends {@link BaseCamera} with event notification.
  * This is the recommended camera class for most applications.
@@ -90,7 +92,7 @@ export default class DefaultBoardCamera implements ObservableBoardCamera {
      * );
      * ```
      */
-    constructor(viewPortWidth?: number, viewPortHeight?: number, position?: Point, rotation?: number, zoomLevel?: number, boundaries?: Boundaries, zoomLevelBoundaries?: ZoomLevelLimits, rotationBoundaries?: RotationLimits | undefined);
+    constructor(options?: CameraOptions);
     /**
      * @description The boundaries of the camera in the world coordinate system.
      *

package/camera/index.d.ts

@@ -18,7 +18,7 @@
  *
  * @module
  */
-export * from "./base";
+export * from './base';
 export * from './utils';
 export * from './default-camera';
 export * from './interface';

package/camera/interface.d.ts

@@ -1,10 +1,10 @@
-import { Point } from "@ue-too/math";
-import { UnSubscribe } from "./update-publisher";
-import { RotationLimits } from "./utils/rotation";
-import { ZoomLevelLimits } from "./utils/zoom";
-import { Boundaries } from "./utils/position";
-import { CameraEventMap, CameraState } from "./update-publisher";
-import { SubscriptionOptions } from "../utils/observable";
+import { Point } from '@ue-too/math';
+import { SubscriptionOptions } from '../utils/observable';
+import { UnSubscribe } from './update-publisher';
+import { CameraEventMap, CameraState } from './update-publisher';
+import { Boundaries } from './utils/position';
+import { RotationLimits } from './utils/rotation';
+import { ZoomLevelLimits } from './utils/zoom';
 /**
  * Observable camera interface that extends {@link BoardCamera} with event subscription capabilities.
  * Allows observers to subscribe to camera state changes such as pan, zoom, and rotation events.
@@ -190,14 +190,6 @@ export interface BoardCamera {
      * If min > max, values are automatically swapped.
      */
     setVerticalBoundaries(min: number, max: number): void;
-    /**
-     * Gets the camera origin position in window coordinates.
-     *
-     * @deprecated This method is deprecated and will be removed in a future version
-     * @param centerInWindow - Center point in window coordinates
-     * @returns The camera origin point (currently just returns the input)
-     */
-    getCameraOriginInWindow(centerInWindow: Point): Point;
     /**
      * Converts a point from viewport coordinates to world coordinates.
      *

package/camera/update-publisher.d.ts

@@ -1,5 +1,5 @@
-import { Point } from "@ue-too/math";
-import { SubscriptionOptions } from "../utils/observable";
+import { Point } from '@ue-too/math';
+import { SubscriptionOptions } from '../utils/observable';
 /**
  * Payload for camera pan (position change) events.
  *
@@ -41,13 +41,13 @@ export type CameraRotateEventPayload = {
  */
 export type CameraEventMap = {
     /** Position change event */
-    "pan": CameraPanEventPayload;
+    pan: CameraPanEventPayload;
     /** Zoom level change event */
-    "zoom": CameraZoomEventPayload;
+    zoom: CameraZoomEventPayload;
     /** Rotation change event */
-    "rotate": CameraRotateEventPayload;
+    rotate: CameraRotateEventPayload;
     /** Any camera change event (union of pan, zoom, rotate) */
-    "all": AllCameraEventPayload;
+    all: AllCameraEventPayload;
 };
 /**
  * Rotation event with discriminated type field for 'all' event handling.
@@ -57,7 +57,7 @@ export type CameraEventMap = {
  */
 export type CameraRotateEvent = {
     /** Event type discriminator */
-    type: "rotate";
+    type: 'rotate';
 } & CameraRotateEventPayload;
 /**
  * Pan event with discriminated type field for 'all' event handling.
@@ -67,7 +67,7 @@ export type CameraRotateEvent = {
  */
 export type CameraPanEvent = {
     /** Event type discriminator */
-    type: "pan";
+    type: 'pan';
 } & CameraPanEventPayload;
 /**
  * Zoom event with discriminated type field for 'all' event handling.
@@ -77,7 +77,7 @@ export type CameraPanEvent = {
  */
 export type CameraZoomEvent = {
     /** Event type discriminator */
-    type: "zoom";
+    type: 'zoom';
 } & CameraZoomEventPayload;
 /**
  * Snapshot of camera state at the time an event occurs.
@@ -128,25 +128,25 @@ export type UnSubscribe = () => void;
  *
  * @category Camera
  */
-export type PanObserver = Callback<"pan">;
+export type PanObserver = Callback<'pan'>;
 /**
  * Callback type for zoom (scale change) events.
  *
  * @category Camera
  */
-export type ZoomObserver = Callback<"zoom">;
+export type ZoomObserver = Callback<'zoom'>;
 /**
  * Callback type for rotation events.
  *
  * @category Camera
  */
-export type RotateObserver = Callback<"rotate">;
+export type RotateObserver = Callback<'rotate'>;
 /**
  * Callback type for the 'all' event that fires on any camera change.
  *
  * @category Camera
  */
-export type AllObserver = Callback<"all">;
+export type AllObserver = Callback<'all'>;
 /**
  * Event publisher for camera state changes using the Observable pattern.
  * Manages subscriptions and notifications for pan, zoom, and rotate events.
@@ -193,7 +193,7 @@ export declare class CameraUpdatePublisher {
      * @param event - Pan event payload containing position delta
      * @param cameraState - Current camera state snapshot
      */
-    notifyPan(event: CameraEventMap["pan"], cameraState: CameraState): void;
+    notifyPan(event: CameraEventMap['pan'], cameraState: CameraState): void;
     /**
      * Notifies all zoom event subscribers.
      * Also triggers the 'all' event with type discrimination.
@@ -201,7 +201,7 @@ export declare class CameraUpdatePublisher {
      * @param event - Zoom event payload containing zoom delta
      * @param cameraState - Current camera state snapshot
      */
-    notifyZoom(event: CameraEventMap["zoom"], cameraState: CameraState): void;
+    notifyZoom(event: CameraEventMap['zoom'], cameraState: CameraState): void;
     /**
      * Notifies all rotation event subscribers.
      * Also triggers the 'all' event with type discrimination.
@@ -209,7 +209,7 @@ export declare class CameraUpdatePublisher {
      * @param event - Rotation event payload containing rotation delta
      * @param cameraState - Current camera state snapshot
      */
-    notifyRotate(event: CameraEventMap["rotate"], cameraState: CameraState): void;
+    notifyRotate(event: CameraEventMap['rotate'], cameraState: CameraState): void;
     /**
      * Subscribes to camera events with type-safe callbacks and optional AbortController support.
      *

package/camera/utils/coordinate-conversion.d.ts

@@ -1,12 +1,12 @@
-import { Point } from "@ue-too/math";
-import { TransformationMatrix } from "./matrix";
+import { Point } from '@ue-too/math';
+import { TransformationMatrix } from './matrix';
 /**
  * Converts a viewport point to world space with respect to a hypothetical camera position.
  * "WRT" = "With Respect To" - calculates where a viewport point would be in world space
  * if the camera were at the target position.
  *
  * @param targetPosition - Hypothetical camera position in world coordinates
- * @param interestPoint - Point in canvas coordinates (origin at bottom-left)
+ * @param interestPoint - Point in canvas coordinates (origin at top-left corner of the canvas element in browser)
  * @param viewPortWidth - Viewport width in CSS pixels
  * @param viewPortHeight - Viewport height in CSS pixels
  * @param cameraZoomLevel - Zoom level to apply
@@ -26,7 +26,7 @@ import { TransformationMatrix } from "./matrix";
  * // if camera moved to (100, 100)?
  * const worldCorner = convert2WorldSpaceWRT(
  *   { x: 100, y: 100 },  // target camera position
- *   { x: 0, y: 1080 },    // top-left in canvas coords
+ *   { x: 0, y: 0 },    // top-left in canvas coords
  *   1920, 1080,           // viewport size
  *   1.0,                  // zoom
  *   0                     // rotation

package/camera/utils/index.d.ts

@@ -20,8 +20,8 @@
  *
  * @module
  */
-export * from "./coordinate-conversion";
-export * from "./matrix";
-export * from "./position";
-export * from "./rotation";
-export * from "./zoom";
+export * from './coordinate-conversion';
+export * from './matrix';
+export * from './position';
+export * from './rotation';
+export * from './zoom';

package/camera/utils/position.d.ts

@@ -1,4 +1,4 @@
-import { Point } from "@ue-too/math";
+import { Point } from '@ue-too/math';
 /**
  * Position boundaries for camera movement in world space.
  * Allows optional constraints on x and y axes independently.
@@ -136,7 +136,16 @@ export declare function isValidBoundaries(boundaries: Boundaries | undefined): b
  *
  * @category Camera
  */
-export declare function boundariesFullyDefined(boundaries: Boundaries | undefined): boolean;
+export declare function boundariesFullyDefined(boundaries: Boundaries | undefined): boundaries is {
+    min: {
+        x: number;
+        y: number;
+    };
+    max: {
+        x: number;
+        y: number;
+    };
+};
 /**
  * Clamps a point to stay within specified boundaries.
  *

package/index.d.ts

@@ -35,8 +35,8 @@
  * requestAnimationFrame(draw);
  * ```
  */
-export * from "./boardify";
-export * from "./camera";
-export * from "./input-interpretation";
-export * from "./utils";
-export { default as Board } from "./boardify";
+export * from './boardify';
+export * from './camera';
+export * from './input-interpretation';
+export * from './utils';
+export { default as Board } from './boardify';