Polygon maths

import {
  signedAreaXZ,
  ringAreaXZ,
  perimeterXZ,
  areaCentroidXZ,
  centroidXZ,
  pointInPolygonXZ,
  ringsOverlap,
  ringStrictlyInside,
  isConvexXZ,
  distancePointToSegmentXZ,
  ringDistanceXZ,
  offsetRingOutwardXZ,
  rotatePointsXZ,
  translatePointsXZ,
  validateAndNormalizeProfile,
  clonePolygonProfile,
} from '@opengeometry/floorkit';

function signedAreaXZ(ring: PointXZ[]): number;

function ringAreaXZ(ring: PointXZ[]): number;

function perimeterXZ(ring: PointXZ[]): number;

function areaCentroidXZ(ring: PointXZ[]): PointXZ;

function centroidXZ(ring: PointXZ[]): PointXZ;

function pointInPolygonXZ(p: PointXZ, ring: PointXZ[]): boolean;

function ringsOverlap(a: PointXZ[], b: PointXZ[]): boolean;

function ringStrictlyInside(inner: PointXZ[], outer: PointXZ[]): boolean;

function isConvexXZ(ring: PointXZ[]): boolean;

function distancePointToSegmentXZ(p: PointXZ, a: PointXZ, b: PointXZ): number;

function ringDistanceXZ(a: PointXZ[], b: PointXZ[]): number;

function offsetRingOutwardXZ(ring: PointXZ[], distance: number): PointXZ[];

function rotatePointsXZ(ring: PointXZ[], angleRad: number, anchor: PointXZ): PointXZ[];

function translatePointsXZ(ring: PointXZ[], dx: number, dz: number): PointXZ[];

function validateAndNormalizeProfile(
  profile: PolygonProfile,
  label: string,
): NormalizedPolygonProfile;

function clonePolygonProfile(profile: PolygonProfile): PolygonProfile;

interface PolygonProfile {
  outerRing: PointXZ[];
  holes?: PointXZ[][];
}

interface NormalizedPolygonProfile {
  outer: PointXZ[];
  holes: PointXZ[][];
}

type Winding = 'CW' | 'CCW';

type PointXZ = [number, number];