Utils

Import these from @grafloria/engine.

Functions

boxesIntersect

Check if two bounding boxes intersect

ts
Copy
function boxesIntersect(box1: BoundingBox, box2: BoundingBox): boolean

clampToBox

Clamp point to bounding box

ts
Copy
function clampToBox(point: Point, box: BoundingBox): Point

createBoundingBox

Create bounding box from position and size

ts
Copy
function createBoundingBox(
  position: Point,
  size: Size
): BoundingBox

deepClone

Deep clone an object with circular reference handling Handles dates, arrays, maps, sets, plain objects, and circular references

ts
Copy
function deepClone<T>(value: T, visited: WeakMap<any, any> = new WeakMap()): T

deepEqual

Check if two values are deeply equal

ts
Copy
function deepEqual(a: any, b: any): boolean

distance

Calculate distance between two points

ts
Copy
function distance(p1: Point, p2: Point): number

expandBox

Expand bounding box by margin

ts
Copy
function expandBox(box: BoundingBox, margin: number): BoundingBox

generateId

Generate a short unique ID (12 characters) Used for internal references

ts
Copy
function generateId(): string

generatePrefixedId

Generate a prefixed ID

ts
Copy
function generatePrefixedId(prefix: string): string

generateUUID

Generate a UUID Used for persistent identifiers

ts
Copy
function generateUUID(): string

isPointInShape

Determine if a point is inside a shape Returns true if point (px, py) is within the shape defined by bounds and shapeConfig

Shape-aware hit detection for accurate mouse interactions

ts
Copy
function isPointInShape(
  px: number,
  py: number,
  bounds: BoundingBox,
  shapeConfig?: ShapeConfig
): boolean

isValidId

Validate if string is a valid ID format

ts
Copy
function isValidId(id: string): boolean

isValidUUID

Validate if string is a valid UUID format

ts
Copy
function isValidUUID(uuid: string): boolean

midpoint

Calculate midpoint between two points

ts
Copy
function midpoint(p1: Point, p2: Point): Point

pointInBox

Check if point is inside bounding box

ts
Copy
function pointInBox(point: Point, box: BoundingBox): boolean

rotatePoint

Rotate point around origin

ts
Copy
function rotatePoint(
  point: Point,
  origin: Point,
  angle: number
): Point

scalePoint

Scale point from origin

ts
Copy
function scalePoint(
  point: Point,
  origin: Point,
  scale: Point
): Point