@synnaxlabs/x 0.44.2 → 0.44.4

package/src/spatial/position/position.spec.ts

@@ -1,211 +0,0 @@
-// Copyright 2025 Synnax Labs, Inc.
-//
-// Use of this software is governed by the Business Source License included in the file
-// licenses/BSL.txt.
-//
-// As of the Change Date specified in that file, in accordance with the Business Source
-// License, use of this software will be governed by the Apache License, Version 2.0,
-// included in the file licenses/APL.txt.
-
-import { describe, expect, it } from "vitest";
-
-import { box } from "@/spatial";
-import { type Alignment } from "@/spatial/base";
-import { location } from "@/spatial/location";
-import { position } from "@/spatial/position";
-
-type Spec = [position.DialogProps, location.XY];
-
-describe("position", () => {
-  describe("dialog", () => {
-    const SPEC_CASE_1: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(45, 55, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-      },
-      location.CENTER_LEFT,
-    ];
-
-    const SPEC_CASE_2: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(45, 55, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-        initial: "top",
-      },
-      location.TOP_CENTER,
-    ];
-
-    const SPEC_CASE_3: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(45, 55, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-        initial: "bottom",
-      },
-      location.BOTTOM_CENTER,
-    ];
-
-    const SPEC_CASE_4: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(45, 55, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-        initial: "left",
-      },
-      location.CENTER_LEFT,
-    ];
-
-    const SPEC_CASE_5: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(45, 55, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-        initial: "right",
-      },
-      location.CENTER_RIGHT,
-    ];
-
-    // Target is in bottom right corner
-    const SPEC_CASE_6: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(90, 90, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-      },
-      location.CENTER_LEFT,
-    ];
-
-    // Target is in the top left corner
-    const SPEC_CASE_7: Spec = [
-      {
-        container: box.construct(0, 0, 100, 100),
-        target: box.construct(0, 0, 10, 10),
-        dialog: box.construct(0, 0, 20, 20),
-      },
-      location.BOTTOM_CENTER,
-    ];
-
-    const SPEC_CASE_8: Spec = [
-      {
-        container: {
-          one: { x: 0, y: 0 },
-          two: { x: 1707, y: 1075 },
-          root: { x: "left", y: "top" },
-        },
-        target: {
-          one: { x: 79, y: 965 },
-          two: { x: 1647, y: 992 },
-          root: { x: "left", y: "top" },
-        },
-        dialog: {
-          one: { x: 79.53125, y: 781 },
-          two: { x: 1647.53125, y: 1141 },
-          root: { x: "left", y: "top" },
-        },
-        initial: { x: "center" },
-        alignments: ["center"],
-      },
-      location.TOP_CENTER,
-    ];
-
-    const SPEC_CASE_9: Spec = [
-      {
-        container: {
-          one: { x: 0, y: 0 },
-          two: { x: 1707, y: 697 },
-          root: { x: "left", y: "top" },
-        },
-        target: {
-          one: { x: 79, y: 587 },
-          two: { x: 1647, y: 614 },
-          root: { x: "left", y: "top" },
-        },
-        dialog: {
-          one: { x: 79, y: 991 },
-          two: { x: 1647, y: 1351 },
-          root: { x: "left", y: "top" },
-        },
-        initial: { x: "center" },
-        alignments: ["center"],
-      },
-      location.TOP_CENTER,
-    ];
-
-    // const SPEC_CASE_10 = [
-    //   {
-    //     container: {
-    //       one: { x: 0, y: 0 },
-    //       two: { x: 1707, y: 697 },
-    //       root: { x: "left", y: "top" },
-    //     },
-    //     target: {
-    //       one: { x: 78, y: 4 },
-    //       two: { x: 278, y: 31 },
-    //       root: { x: "left", y: "top" },
-    //     },
-    //     dialog: {
-    //       one: { x: 78, y: 4 },
-    //       two: { x: 78, y: 4 },
-    //       root: { x: "left", y: "top" },
-    //     },
-    //     alignments: ["end"],
-    //     disable: ["center"],
-    //   },
-    //   location.BOTTOM_LEFT,
-    // ];
-
-    const SPECS: Spec[] = [
-      SPEC_CASE_1,
-      SPEC_CASE_2,
-      SPEC_CASE_3,
-      SPEC_CASE_4,
-      SPEC_CASE_5,
-      SPEC_CASE_6,
-      SPEC_CASE_7,
-      SPEC_CASE_8,
-      SPEC_CASE_9,
-      // SPEC_CASE_10,
-    ];
-
-    SPECS.forEach(([props, expected]) => {
-      it(`should position dialog correctly`, () => {
-        expect(position.dialog(props).location).toEqual(expected);
-      });
-    });
-  });
-  describe("getRoot", () => {
-    const SPECS: Array<[location.XY, Alignment, location.XY]> = [
-      [location.TOP_LEFT, "start", location.BOTTOM_RIGHT],
-      [location.TOP_LEFT, "center", location.BOTTOM_CENTER],
-      [location.TOP_LEFT, "end", location.BOTTOM_LEFT],
-      [location.TOP_RIGHT, "start", location.BOTTOM_LEFT],
-      [location.TOP_RIGHT, "center", location.BOTTOM_CENTER],
-      [location.TOP_RIGHT, "end", location.BOTTOM_RIGHT],
-      [location.TOP_CENTER, "start", location.BOTTOM_LEFT],
-      [location.TOP_CENTER, "center", location.BOTTOM_CENTER],
-      [location.TOP_CENTER, "end", location.BOTTOM_RIGHT],
-      [location.CENTER_LEFT, "start", location.BOTTOM_RIGHT],
-      [location.CENTER_LEFT, "center", location.CENTER_RIGHT],
-      [location.CENTER_LEFT, "end", location.TOP_RIGHT],
-      [location.CENTER_RIGHT, "start", location.BOTTOM_LEFT],
-      [location.CENTER_RIGHT, "center", location.CENTER_LEFT],
-      [location.CENTER_RIGHT, "end", location.TOP_LEFT],
-      [location.BOTTOM_LEFT, "start", location.TOP_RIGHT],
-      [location.BOTTOM_LEFT, "center", location.TOP_CENTER],
-      [location.BOTTOM_LEFT, "end", location.TOP_LEFT],
-      [location.BOTTOM_RIGHT, "start", location.TOP_LEFT],
-      [location.BOTTOM_RIGHT, "center", location.TOP_CENTER],
-      [location.BOTTOM_RIGHT, "end", location.TOP_RIGHT],
-      [location.BOTTOM_CENTER, "start", location.TOP_LEFT],
-      [location.BOTTOM_CENTER, "center", location.TOP_CENTER],
-      [location.BOTTOM_CENTER, "end", location.TOP_RIGHT],
-    ];
-    SPECS.forEach(([option, order, expected]) => {
-      it(`should position get the correct positioning root for ${location.xyToString(option)} and ${order}`, () => {
-        expect(position.getRoot(option, order)).toEqual(expected);
-      });
-    });
-  });
-});

package/src/spatial/position/position.ts

@@ -1,157 +0,0 @@
-// Copyright 2025 Synnax Labs, Inc.
-//
-// Use of this software is governed by the Business Source License included in the file
-// licenses/BSL.txt.
-//
-// As of the Change Date specified in that file, in accordance with the Business Source
-// License, use of this software will be governed by the Apache License, Version 2.0,
-// included in the file licenses/APL.txt.
-
-import { type Alignment, type XLocation, type YLocation } from "@/spatial/base";
-import { box } from "@/spatial/box";
-import { direction } from "@/spatial/direction";
-import { location } from "@/spatial/location";
-
-export interface DialogProps {
-  container: box.Crude;
-  target: box.Crude;
-  dialog: box.Crude;
-  alignments?: Alignment[];
-  initial?: location.Outer | Partial<location.XY> | location.XY;
-  prefer?: Array<location.Outer | Partial<location.XY> | location.XY>;
-  disable?: Array<location.Location | Partial<location.XY>>;
-}
-
-export const parseLocationOptions = (
-  initial?: location.Outer | Partial<location.XY> | location.XY,
-): Partial<location.XY> => {
-  if (initial == null) return { x: undefined, y: undefined };
-  const parsedXYLoc = location.xy.safeParse(initial);
-  if (parsedXYLoc.success) return parsedXYLoc.data;
-  const parsedLoc = location.location.safeParse(initial);
-  if (parsedLoc.success) {
-    const isX = direction.construct(parsedLoc.data) === "x";
-    return isX
-      ? { x: parsedLoc.data as XLocation, y: undefined }
-      : { x: undefined, y: parsedLoc.data as YLocation };
-  }
-  return initial as Partial<location.XY>;
-};
-
-export interface DialogReturn {
-  location: location.XY;
-  adjustedDialog: box.Box;
-}
-
-export const dialog = ({
-  container: containerCrude,
-  target: targetCrude,
-  dialog: dialogCrude,
-  initial,
-  prefer,
-  alignments = ["start"],
-  disable = [],
-}: DialogProps): DialogReturn => {
-  const initialLocs = parseLocationOptions(initial);
-
-  let options = location.XY_LOCATIONS;
-  if (prefer != null) {
-    const parsedPrefer = prefer.map((p) => parseLocationOptions(p));
-    options = options.slice().sort((a, b) => {
-      const hasPreferA = parsedPrefer.findIndex((p) => location.xyMatches(a, p));
-      const hasPreferB = parsedPrefer.findIndex((p) => location.xyMatches(b, p));
-      if (hasPreferA > -1 && hasPreferB > -1) return hasPreferA - hasPreferB;
-      if (hasPreferA > -1) return -1;
-      if (hasPreferB > -1) return 1;
-      return 0;
-    });
-  }
-  const mappedOptions = options
-    .filter(
-      (l) =>
-        !location.xyEquals(l, location.CENTER) &&
-        (initialLocs.x == null || l.x === initialLocs.x) &&
-        (initialLocs.y == null || l.y === initialLocs.y) &&
-        !disable.some((d) => location.xyMatches(l, d)),
-    )
-    .map((l) => alignments?.map((a) => [l, a]))
-    .flat() as Array<[location.XY, Alignment]>;
-
-  const container = box.construct(containerCrude);
-  const target = box.construct(targetCrude);
-  const dialog = box.construct(dialogCrude);
-
-  // maximum value of a number in js
-  let bestOptionArea = -Infinity;
-  const res: DialogReturn = { location: location.CENTER, adjustedDialog: dialog };
-  mappedOptions.forEach(([option, alignment]) => {
-    const [adjustedBox, area] = evaluateOption({
-      option,
-      alignment,
-      container,
-      target,
-      dialog,
-    });
-    if (area > bestOptionArea) {
-      bestOptionArea = area;
-      res.location = option;
-      res.adjustedDialog = adjustedBox;
-    }
-  });
-
-  return res;
-};
-
-interface EvaluateOptionProps {
-  option: location.XY;
-  alignment: Alignment;
-  container: box.Box;
-  target: box.Box;
-  dialog: box.Box;
-}
-
-const evaluateOption = ({
-  option,
-  alignment,
-  container,
-  target,
-  dialog,
-}: EvaluateOptionProps): [box.Box, number] => {
-  const root = getRoot(option, alignment);
-  const targetPoint = box.xyLoc(target, option);
-  const dialogBox = box.constructWithAlternateRoot(
-    targetPoint.x,
-    targetPoint.y,
-    box.width(dialog),
-    box.height(dialog),
-    root,
-    location.TOP_LEFT,
-  );
-  const area = box.area(box.intersection(dialogBox, container));
-  return [dialogBox, area];
-};
-
-const X_ALIGNMENT_MAP: Record<Alignment, location.X | location.Center> = {
-  start: "left",
-  center: "center",
-  end: "right",
-};
-
-const Y_ALIGNMENT_MAP: Record<Alignment, location.Y | location.Center> = {
-  start: "bottom",
-  center: "center",
-  end: "top",
-};
-
-export const getRoot = (option: location.XY, alignment: Alignment): location.XY => {
-  const out: location.XY = { x: "center", y: "center" };
-  if (option.y !== "center") {
-    out.y = location.swap(option.y) as location.Y;
-    const swapper = option.x === "left" ? location.swap : (v: location.Location) => v;
-    out.x = swapper(X_ALIGNMENT_MAP[alignment]) as location.X;
-  } else {
-    out.x = location.swap(option.x) as location.X;
-    out.y = Y_ALIGNMENT_MAP[alignment];
-  }
-  return out;
-};