@embedpdf/utils 1.3.15 → 1.4.0

package/dist/shared/components/counter-rotate-container.d.ts

@@ -0,0 +1,19 @@
+import { Rect, Rotation } from '@embedpdf/models';
+import { ReactNode, CSSProperties } from '../../react/adapter.ts';
+interface CounterRotateProps {
+    rect: Rect;
+    rotation: Rotation;
+}
+export interface MenuWrapperProps {
+    style: CSSProperties;
+    ref: (el: HTMLDivElement | null) => void;
+}
+interface CounterRotateComponentProps extends CounterRotateProps {
+    children: (props: {
+        matrix: string;
+        rect: Rect;
+        menuWrapperProps: MenuWrapperProps;
+    }) => ReactNode;
+}
+export declare function CounterRotate({ children, ...props }: CounterRotateComponentProps): import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1 @@
+export * from './counter-rotate-container';

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

@@ -0,0 +1,3 @@
+export * from './use-drag-resize';
+export * from './use-interaction-handles';
+export * from './use-double-press-props';

package/dist/shared/hooks/use-double-press-props.d.ts

@@ -0,0 +1,11 @@
+import { dblClickProp, PointerEvent } from '../../react/adapter.ts';
+type DoublePressOptions = {
+    delay?: number;
+    tolerancePx?: number;
+};
+type DoubleHandler<T extends Element> = ((e: PointerEvent<T> | MouseEvent) => void) | undefined;
+type DoubleProps<K extends string> = Partial<Record<K, (e: any) => void>> & {
+    onPointerUp?: (e: any) => void;
+};
+export declare function useDoublePressProps<T extends Element = Element, K extends string = typeof dblClickProp>(onDouble?: DoubleHandler<T>, { delay, tolerancePx }?: DoublePressOptions): DoubleProps<K>;
+export {};

package/dist/shared/hooks/use-drag-resize.d.ts

@@ -0,0 +1,27 @@
+import { PointerEvent } from '../../react/adapter.ts';
+import { DragResizeConfig, InteractionEvent, ResizeHandle } from '../plugin-interaction-primitives';
+export interface UseDragResizeOptions extends DragResizeConfig {
+    onUpdate?: (event: InteractionEvent) => void;
+    enabled?: boolean;
+}
+export interface ResizeHandleEventProps {
+    onPointerDown: (e: PointerEvent) => void;
+    onPointerMove: (e: PointerEvent) => void;
+    onPointerUp: (e: PointerEvent) => void;
+    onPointerCancel: (e: PointerEvent) => void;
+}
+export declare function useDragResize(options: UseDragResizeOptions): {
+    dragProps: {
+        onPointerDown: (e: PointerEvent) => void;
+        onPointerMove: (e: PointerEvent) => void;
+        onPointerUp: (e: PointerEvent) => void;
+        onPointerCancel: (e: PointerEvent) => void;
+    } | {
+        onPointerDown?: undefined;
+        onPointerMove?: undefined;
+        onPointerUp?: undefined;
+        onPointerCancel?: undefined;
+    };
+    createResizeProps: (handle: ResizeHandle) => ResizeHandleEventProps;
+    createVertexProps: (vertexIndex: number) => ResizeHandleEventProps;
+};

package/dist/shared/hooks/use-interaction-handles.d.ts

@@ -0,0 +1,33 @@
+import { PointerEvent, CSSProperties } from '../../react/adapter.ts';
+import { UseDragResizeOptions } from './use-drag-resize';
+import { ResizeUI, VertexUI } from '../plugin-interaction-primitives/utils';
+export type HandleElementProps = {
+    key: string | number;
+    style: CSSProperties;
+    onPointerDown: (e: PointerEvent) => void;
+    onPointerMove: (e: PointerEvent) => void;
+    onPointerUp: (e: PointerEvent) => void;
+    onPointerCancel: (e: PointerEvent) => void;
+} & Record<string, any>;
+export declare function useInteractionHandles(opts: {
+    controller: UseDragResizeOptions;
+    resizeUI?: ResizeUI;
+    vertexUI?: VertexUI;
+    includeVertices?: boolean;
+    handleAttrs?: (h: 'nw' | 'ne' | 'sw' | 'se' | 'n' | 'e' | 's' | 'w') => Record<string, any> | void;
+    vertexAttrs?: (i: number) => Record<string, any> | void;
+}): {
+    dragProps: {
+        onPointerDown: (e: PointerEvent) => void;
+        onPointerMove: (e: PointerEvent) => void;
+        onPointerUp: (e: PointerEvent) => void;
+        onPointerCancel: (e: PointerEvent) => void;
+    } | {
+        onPointerDown?: undefined;
+        onPointerMove?: undefined;
+        onPointerUp?: undefined;
+        onPointerCancel?: undefined;
+    };
+    resize: HandleElementProps[];
+    vertices: HandleElementProps[];
+};

package/dist/shared/index.d.ts

@@ -0,0 +1,2 @@
+export * from './components';
+export * from './hooks';

package/dist/shared/plugin-interaction-primitives/drag-resize-controller.d.ts

@@ -0,0 +1,68 @@
+import { Position, Rect } from '@embedpdf/models';
+export interface DragResizeConfig {
+    element: Rect;
+    vertices?: Position[];
+    constraints?: {
+        minWidth?: number;
+        minHeight?: number;
+        maxWidth?: number;
+        maxHeight?: number;
+        boundingBox?: {
+            width: number;
+            height: number;
+        };
+    };
+    maintainAspectRatio?: boolean;
+    pageRotation?: number;
+    scale?: number;
+}
+export type InteractionState = 'idle' | 'dragging' | 'resizing' | 'vertex-editing';
+export type ResizeHandle = 'nw' | 'ne' | 'sw' | 'se' | 'n' | 'e' | 's' | 'w';
+export interface TransformData {
+    type: 'move' | 'resize' | 'vertex-edit';
+    changes: {
+        rect?: Rect;
+        vertices?: Position[];
+    };
+    metadata?: {
+        handle?: ResizeHandle;
+        vertexIndex?: number;
+        maintainAspectRatio?: boolean;
+    };
+}
+export interface InteractionEvent {
+    state: 'start' | 'move' | 'end';
+    transformData?: TransformData;
+}
+/**
+ * Pure geometric controller that manages drag/resize/vertex-edit logic.
+ */
+export declare class DragResizeController {
+    private config;
+    private onUpdate;
+    private state;
+    private startPoint;
+    private startElement;
+    private activeHandle;
+    private currentPosition;
+    private activeVertexIndex;
+    private startVertices;
+    private currentVertices;
+    constructor(config: DragResizeConfig, onUpdate: (event: InteractionEvent) => void);
+    updateConfig(config: Partial<DragResizeConfig>): void;
+    startDrag(clientX: number, clientY: number): void;
+    startResize(handle: ResizeHandle, clientX: number, clientY: number): void;
+    startVertexEdit(vertexIndex: number, clientX: number, clientY: number): void;
+    move(clientX: number, clientY: number): void;
+    end(): void;
+    cancel(): void;
+    private reset;
+    private getCurrentPosition;
+    private calculateDelta;
+    private transformDelta;
+    private clampPoint;
+    private calculateVertexPosition;
+    private calculateDragPosition;
+    private calculateResizePosition;
+    private applyConstraints;
+}

package/dist/shared/plugin-interaction-primitives/index.d.ts

@@ -0,0 +1,2 @@
+export * from './drag-resize-controller';
+export * from './utils';

package/dist/shared/plugin-interaction-primitives/utils.d.ts

@@ -0,0 +1,22 @@
+import { Position } from '@embedpdf/models';
+import { ResizeHandle, DragResizeConfig } from './drag-resize-controller';
+export type QuarterTurns = 0 | 1 | 2 | 3;
+export interface ResizeUI {
+    handleSize?: number;
+    spacing?: number;
+    offsetMode?: 'outside' | 'inside' | 'center';
+    includeSides?: boolean;
+    zIndex?: number;
+    rotationAwareCursor?: boolean;
+}
+export interface VertexUI {
+    vertexSize?: number;
+    zIndex?: number;
+}
+export interface HandleDescriptor {
+    handle: ResizeHandle;
+    style: Record<string, number | string>;
+    attrs?: Record<string, any>;
+}
+export declare function describeResizeFromConfig(cfg: DragResizeConfig, ui?: ResizeUI): HandleDescriptor[];
+export declare function describeVerticesFromConfig(cfg: DragResizeConfig, ui?: VertexUI, liveVertices?: Position[]): HandleDescriptor[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@embedpdf/utils",
-  "version": "1.3.15",
+  "version": "1.4.0",
   "private": false,
   "description": "Shared utility helpers (geometry, tasks, logging, PDF primitives) that underpin every package in the EmbedPDF ecosystem.",
   "type": "module",
@@ -47,8 +47,8 @@
   "devDependencies": {
     "typescript": "^5.0.0",
     "@types/react": "^18.2.0",
-    "@embedpdf/build": "1.0.1",
-    "@embedpdf/models": "1.3.15"
+    "@embedpdf/models": "1.4.0",
+    "@embedpdf/build": "1.1.0"
   },
   "peerDependencies": {
     "react": ">=16.8.0",