@likec4/core 1.47.0 → 1.49.0

package/dist/_chunks/vector.d.mts

@@ -0,0 +1,198 @@
+//#region src/geometry/types.d.ts
+interface XYPoint {
+  x: number;
+  y: number;
+}
+interface Dimensions {
+  width: number;
+  height: number;
+}
+type Point = readonly [x: number, y: number];
+declare function isPoint(point: unknown): point is Point;
+/**
+ * Converts between Point (tuple) and XYPoint (object) representations.
+ *
+ * @param point - The point to convert (either XYPoint or Point tuple)
+ * @returns The converted point in the alternate format
+ *
+ * @example
+ * ```ts
+ * // Convert tuple to object
+ * convertPoint([10, 20]) // returns { x: 10, y: 20 }
+ *
+ * // Convert object to tuple
+ * convertPoint({ x: 10, y: 20 }) // returns [10, 20]
+ * ```
+ */
+declare function convertPoint(point: Point): XYPoint;
+declare function convertPoint(point: XYPoint): Point;
+//#endregion
+//#region src/geometry/bbox.d.ts
+interface BBox {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+declare const BBox: {
+  center({
+    x,
+    y,
+    width,
+    height
+  }: BBox): XYPoint;
+  /**
+   * Returns the four corner points of the box in clockwise order starting from top-left
+   */
+  toPoints({
+    x,
+    y,
+    width,
+    height
+  }: BBox): [XYPoint, XYPoint, XYPoint, XYPoint];
+  fromPoints(points: Point[]): BBox;
+  merge(...boxes: BBox[]): BBox;
+  fromRectBox(rect: RectBox): BBox;
+  toRectBox(box: BBox): RectBox;
+  expand(box: BBox, plus: number): BBox;
+  shrink(box: BBox, minus: number): BBox;
+  /**
+   * Returns true if `a` includes `b` (i.e. `b` is inside `a`)
+   */
+  includes(a: BBox, b: BBox): boolean;
+};
+interface RectBox {
+  x1: number;
+  y1: number;
+  x2: number;
+  y2: number;
+}
+declare const RectBox: {
+  center({
+    x1,
+    y1,
+    x2,
+    y2
+  }: RectBox): XYPoint;
+  fromPoints(points: Point[]): RectBox;
+  merge(...boxes: RectBox[]): RectBox;
+  toBBox(box: RectBox): BBox;
+  /**
+   * Returns true if `a` includes `b` (i.e. `b` is inside `a`)
+   */
+  includes(a: RectBox, b: RectBox): boolean;
+};
+//#endregion
+//#region src/geometry/vector.d.ts
+interface VectorValue {
+  readonly x: number;
+  readonly y: number;
+}
+declare class Vector implements VectorValue {
+  readonly x: number;
+  readonly y: number;
+  constructor(x: number, y: number);
+  static create(position: VectorValue): Vector;
+  static create(x: number, y: number): Vector;
+  /**
+   * Adds two vectors.
+   * @param a The first vector.
+   * @param b The second vector.
+   * @returns The sum of the two vectors.
+   */
+  static add(a: VectorValue, b: VectorValue): VectorValue;
+  /**
+   * Subtracts two vectors.
+   * @param a The first vector.
+   * @param b The second vector.
+   * @returns The difference of the two vectors.
+   */
+  static subtract(a: VectorValue, b: VectorValue): VectorValue;
+  /**
+   * Multiplies a vector by a scalar.
+   * @param a The vector.
+   * @param b The scalar.
+   * @returns The scaled vector.
+   */
+  static multiply(a: VectorValue, b: number): VectorValue;
+  /**
+   * Divides a vector by a scalar.
+   * @param a The vector.
+   * @param b The scalar.
+   * @returns The scaled vector.
+   */
+  static divide(a: VectorValue, b: number): VectorValue;
+  /**
+   * Calculates the dot product of the vectors.
+   * @param a The first vector.
+   * @param b The second vector.
+   * @returns The dot product.
+   */
+  static dot(a: VectorValue, b: VectorValue): number;
+  /**
+   * Adds the given vector to this vector.
+   * @param b The vector to add.
+   * @returns A new vector that is the sum of this vector and the given vector.
+   */
+  add(b: VectorValue): Vector;
+  /**
+   * Subtracts the given vector from this vector.
+   * @param b The vector to subtract.
+   * @returns A new vector that is the difference of this vector and the given vector.
+   */
+  subtract(b: VectorValue): Vector;
+  /**
+   * Multiplies this vector by a scalar.
+   * @param b The scalar to multiply by.
+   * @returns A new vector that is the product of this vector and the given scalar.
+   */
+  multiply(b: number): Vector;
+  /**
+   * Divides this vector by a scalar.
+   * @param b The scalar to divide by.
+   * @returns A new vector that is the quotient of this vector and the given scalar.
+   */
+  divide(b: number): Vector;
+  /**
+   * Calculates the dot product of this vector and another vector.
+   * @param b The other vector.
+   * @returns The dot product.
+   */
+  dot(b: VectorValue): number;
+  /**
+   * Calculates the cross product of this vector and another vector.
+   * The cross product of two 2D vectors is a scalar value: a.x * b.y - a.y * b.x
+   * @param b The other vector.
+   * @returns The cross product as a scalar.
+   */
+  cross(b: VectorValue): number;
+  /**
+   * Calculates the length (magnitude) of this vector.
+   * @returns The length of the vector.
+   */
+  length(): number;
+  /**
+   * Normalizes the vector (makes it unit length, i.e., has a length of 1).
+   * @returns A new vector that is the normalized version of this vector.
+   */
+  normalize(): Vector;
+  /**
+   * Rounds the components of the vector to the nearest integers.
+   * @returns A new vector with rounded components.
+   */
+  round(): Vector;
+  /**
+   * Truncates the components of the vector (removes the decimal part).
+   * @returns A new vector with truncated components.
+   */
+  trunc(): Vector;
+  /**
+   * Converts the vector to a plain object.
+   * @returns An object with x and y properties.
+   */
+  toObject(): VectorValue;
+}
+declare function vector(source: VectorValue | Vector): Vector;
+declare function vector(x: number, y: number): Vector;
+//#endregion
+export { RectBox as a, XYPoint as c, BBox as i, convertPoint as l, VectorValue as n, Dimensions as o, vector as r, Point as s, Vector as t, isPoint as u };

package/dist/_chunks/vector.mjs

@@ -0,0 +1 @@
+import{Q as t}from"./libs/remeda.mjs";import{Q as invariant}from"./to-text.mjs";function isPoint(e){return Array.isArray(e)&&e.length===2&&typeof e[0]==`number`&&typeof e[1]==`number`}function convertPoint(e){return isPoint(e)?{x:e[0],y:e[1]}:[e.x,e.y]}const BBox={center({x:e,y:n,width:r,height:i}){return{x:e+r/2,y:n+i/2}},toPoints({x:e,y:n,width:r,height:i}){return[{x:e,y:n},{x:e+r,y:n},{x:e+r,y:n+i},{x:e,y:n+i}]},fromPoints(e){let{x1:n,y1:r,x2:i,y2:a}=RectBox.fromPoints(e);return{x:n,y:r,width:i-n,height:a-r}},merge(...r){if(invariant(t(r,1),`No boxes provided`),r.length===1)return r[0];let i=r[0].x,a=r[0].y,o=r[0].x+r[0].width,s=r[0].y+r[0].height;for(let e=1;e<r.length;e++){let n=r[e];i=Math.min(i,n.x),a=Math.min(a,n.y),o=Math.max(o,n.x+n.width),s=Math.max(s,n.y+n.height)}return{x:Math.floor(i),y:Math.floor(a),width:Math.round(o-i),height:Math.round(s-a)}},fromRectBox(e){return{x:Math.min(e.x1,e.x2),y:Math.min(e.y1,e.y2),width:Math.abs(e.x2-e.x1),height:Math.abs(e.y2-e.y1)}},toRectBox(e){return{x1:e.x,y1:e.y,x2:e.x+e.width,y2:e.y+e.height}},expand(e,n){return n===0?e:{x:e.x-n,y:e.y-n,width:e.width+n*2,height:e.height+n*2}},shrink(e,n){return n===0?e:{x:e.x+n,y:e.y+n,width:e.width-n*2,height:e.height-n*2}},includes(e,n){return e===n?!0:e.x<=n.x&&e.y<=n.y&&e.x+e.width>=n.x+n.width&&e.y+e.height>=n.y+n.height}},RectBox={center({x1:e,y1:n,x2:r,y2:i}){return{x:(e+r)/2,y:(n+i)/2}},fromPoints(e){invariant(e.length>0,`At least one point is required`);let r=1/0,i=1/0,a=-1/0,o=-1/0;for(let[n,s]of e)r=Math.min(r,n),i=Math.min(i,s),a=Math.max(a,n),o=Math.max(o,s);return{x1:r,y1:i,x2:a,y2:o}},merge(...e){invariant(e.length>0,`No boxes provided`);let r=1/0,i=1/0,a=-1/0,o=-1/0;for(let n of e)r=Math.min(r,n.x1),i=Math.min(i,n.y1),a=Math.max(a,n.x2),o=Math.max(o,n.y2);return{x1:r,y1:i,x2:a,y2:o}},toBBox(e){return{x:e.x1,y:e.y1,width:e.x2-e.x1,height:e.y2-e.y1}},includes(e,n){return e===n?!0:e.x1<=n.x1&&e.y1<=n.y1&&e.x2>=n.x2&&e.y2>=n.y2}};var Vector=class e{constructor(e,r){this.x=e,this.y=r,invariant(typeof e==`number`&&!isNaN(e)&&isFinite(e)&&typeof r==`number`&&!isNaN(r)&&isFinite(r),`Invalid arguments for Vector: (${e}, ${r})`)}static create(...n){return n.length===2?new e(n[0],n[1]):new e(n[0].x,n[0].y)}static add(e,n){return{x:e.x+n.x,y:e.y+n.y}}static subtract(e,n){return{x:e.x-n.x,y:e.y-n.y}}static multiply(e,n){return{x:e.x*n,y:e.y*n}}static divide(e,n){return{x:e.x/n,y:e.y/n}}static dot(e,n){return e.x*n.x+e.y*n.y}add(n){return new e(this.x+n.x,this.y+n.y)}subtract(n){return new e(this.x-n.x,this.y-n.y)}multiply(n){return new e(this.x*n,this.y*n)}divide(n){return new e(this.x/n,this.y/n)}dot(e){return this.x*e.x+this.y*e.y}cross(e){return this.x*e.y-this.y*e.x}length(){return this.x===0&&this.y===0?0:Math.sqrt(this.x**2+this.y**2)}normalize(){let n=this.length();return n===0?new e(0,0):new e(this.x/n,this.y/n)}round(){return new e(Math.round(this.x),Math.round(this.y))}trunc(){return new e(Math.trunc(this.x),Math.trunc(this.y))}toObject(){return{x:this.x,y:this.y}}};function vector(...e){return e.length===1&&e[0]instanceof Vector?e[0]:e.length===2?new Vector(e[0],e[1]):new Vector(e[0].x,e[0].y)}export{convertPoint as a,RectBox as i,vector as n,isPoint as o,BBox as r,Vector as t};