@trakit/objects 0.0.5 → 0.0.7

package/API/Geometry/Interfaces.d.ts

@@ -1,111 +0,0 @@
-/**
- * A coordinate on a flat surface.
- */
-export interface IPoint {
-    /**
-     * Horizontal coordinate.
-     */
-    x: number;
-    /**
-     * Vertical coordinate.
-     */
-    y: number;
-}
-/**
- * Returns true if the given point conforms to the {@link IPoint} interface.
- * @param dot
- * @returns
- */
-export declare function IPoint_instanceOf(dot: any): dot is IPoint;
-/**
- *
- * @param dot
- * @returns
- */
-export declare function IPoint_clone(dot: IPoint): IPoint;
-/**
- * A boundary on a flat surface based on a centre point and a radius.
- */
-export interface IRadial extends IPoint {
-    /**
-     * Radius.
-     */
-    r: number;
-}
-/**
- * The types used to extend a {@link Radial}'s radius.
- */
-export type RadialExpansion = IPoint | IRadial | RadialExpansion[];
-/**
- * Returns true if the given radial conforms to the {@link IRadial} interface.
- * @param radial
- * @returns
- */
-export declare function IRadial_instanceOf(radial: any): radial is IRadial;
-/**
- *
- * @param circle
- * @returns
- */
-export declare function IRadial_clone(circle: IRadial): IRadial;
-/**
- * A rectangular boundary on a flat surface.
- */
-export interface IRectangle {
-    /**
-     * Left-most horizontal coordinate
-     */
-    left: number;
-    /**
-     * Highest vertical coordinate.
-     */
-    top: number;
-    /**
-     * Right-most horizontal coordinate
-     */
-    right: number;
-    /**
-     * Lowest vertical coordinate
-     */
-    bottom: number;
-}
-/**
- * Returns true if the given rect conforms to the {@link Rectangle} interface.
- * @param rect
- */
-export declare function IRectangle_instanceOf(rect: any): rect is IRectangle;
-/**
- *
- * @param rect
- * @returns
- */
-export declare function IRectangle_clone(rect: IRectangle): IRectangle;
-/**
- * The types used to extend a {@link Rectangle}'s edges.
- */
-export type RectangleExpansion = IPoint | IRectangle | IRadial | RectangleExpansion[];
-/**
- * Dimensions on a flat surface.
- */
-export interface ISize {
-    /**
-     * Width.
-     */
-    width: number;
-    /**
-     * Height.
-     */
-    height: number;
-}
-/**
- * Returns true if the given size conforms to the {@link Size} interface.
- * @param size
- * @returns
- */
-export declare function ISize_instanceOf(size: any): size is ISize;
-/**
- *
- * @param size
- * @returns
- */
-export declare function ISize_clone(size: ISize): ISize;

package/API/Geometry/Point.d.ts

@@ -1,81 +0,0 @@
-import { ISerializable } from '../Interfaces/ISerializable';
-import { JsonObject } from '../Types';
-import { IPoint } from './Interfaces';
-import { Radial } from './Radial';
-/**
- * A coordinate on a flat surface.
- */
-export declare class Point implements IPoint, ISerializable {
-    /**
-     * Returns a new {@link Radial} from the given object.
-     * @param json
-     */
-    static fromJSON(json: IPoint | JsonObject): Point;
-    /**
-     * Horizontal coordinate.
-     */
-    x: number;
-    /**
-     * Vertical coordinate.
-     */
-    y: number;
-    constructor(x: number, y: number);
-    /**
-     * Returns a string representation of this {@link Point}.
-     * @param delimiter	The boundary is delimited by a comma (,) by default, but you can override with your own value.
-     * @returns A string in the format of "x,y".
-     */
-    toString(delimiter?: string): string;
-    /**
-     * Creates a literal of this {@link Point}.
-     * Used internally by {@link JSON.stringify}.
-     */
-    toJSON(): IPoint;
-    /**
-     * Creates a duplicate of this {@link Point}.
-     */
-    copy(): Point;
-    /**
-     * Compares this {@link Point} to another to see if they are equal.
-     * @param point	The other {@link Point} to compare.
-     * @param precision	The degree of precision to use; default is full precision.
-     */
-    isEqual(point: IPoint, precision?: number): point is IPoint;
-    /**
-     * Calculates the distance between two {@link Point}s.
-     * @param point	The other {@link Point} to compare
-     */
-    distanceTo(point: IPoint): number;
-    /**
-     * Calculates the angle (in degrees) to the given {@link Point}.
-     * @param point
-     */
-    angleTo(point: IPoint): number;
-    /**
-     * Updates this {@link Point} with the given angle and distance.
-     * @param distance
-     * @param degrees
-     */
-    translateTo(distance: number, degrees: number): this;
-    /**
-     * Updates this {@link Point} with the given offset.
-     * @param dot
-     */
-    offsetTo(dot: IPoint): this;
-    /**
-     * Creates a new {@link Point} at the given angle and distance.
-     * @param distance
-     * @param degrees
-     */
-    toTranslated(distance: number, degrees: number): Point;
-    /**
-     * Creates a new {@link Point} based on the given offset.
-     * @param offset
-     */
-    toOffset(offset: IPoint): Point;
-    /**
-     * Creates a new {@link Radial} based on the given radius.
-     * @param radius
-     */
-    toRadial(radius: number): Radial;
-}

package/API/Geometry/Radial.d.ts

@@ -1,110 +0,0 @@
-import { ISerializable } from '../Interfaces/ISerializable';
-import { JsonObject } from '../Types';
-import { IPoint, IRadial, RadialExpansion } from './Interfaces';
-import { Point } from './Point';
-import { Rectangle } from './Rectangle';
-import { Size } from './Size';
-/**
- * A boundary on a flat surface based on a centre point and a radius.
- */
-export declare class Radial implements IRadial, IPoint, ISerializable {
-    /**
-     * Returns a new {@link Radial} from the given object.
-     * @param object
-     */
-    static fromJSON(json: IRadial | JsonObject): Radial;
-    /**
-     * Left coordinate.
-     */
-    x: number;
-    /**
-     * Top coordinate.
-     */
-    y: number;
-    /**
-     * Radial distance.
-     */
-    r: number;
-    constructor(x?: number, y?: number, r?: number);
-    /**
-     * Returns a string representation of this {@link Radial}.
-     * @param delimiter	The boundary is delimited by a comma (,) by default, but you can override with your own value.
-     * @returns A string in the format of "x,y,r".
-     */
-    toString(delimiter?: string): string;
-    /**
-     * Creates a literal of this {@link Radial}.
-     * Used internally by {@link JSON.stringify}.
-     */
-    toJSON(): IRadial;
-    /**
-     * Creates a duplicate of this {@link Radial}.
-     */
-    copy(): Radial;
-    /**
-     * Compares this Point to another to see if they are equal.
-     * @param circle	The other {@link IRadial} to compare
-     * @param precision	The degree of precision to use; default is full precision.
-     */
-    isEqual(circle: IRadial, precision?: number): boolean;
-    /**
-     * Determines if the given {@link IPoint} is contained by this Radial
-     * @param point
-     */
-    contains(point: IPoint): boolean;
-    /**
-     * Determines if the given {@link IRadial} is overlaps this {@link Radial} in any way
-     * @param circle
-     */
-    overlaps(circle: IRadial): boolean;
-    /**
-     * Returns the centre point representation.
-     */
-    getCentre(): Point;
-    /**
-     * Returns the {@link Size} of the diameter.
-     */
-    getSize(): Size;
-    /**
-     * Worker function that actually extends the boundary to envelop the given point(s)/boundary(s).
-     * @param object
-     */
-    __expander(object: RadialExpansion): void;
-    /**
-     * Extends the boundary to envelop the given point(s).
-     * @param object	The objects used to extend the radius.
-     */
-    extend(object: RadialExpansion): this;
-    /**
-     * Increases the boundary radius.
-     * @param length
-     */
-    grow(length: number): this;
-    /**
-     * Updates this {@link Radial} with the given angle and distance.
-     * @param distance
-     * @param degrees
-     */
-    translateTo(distance: number, degrees: number): this;
-    /**
-     * Updates this {@link Radial} with the given offset.
-     * @param dot
-     */
-    offsetTo(dot: IPoint): this;
-    /**
-     * Creates a new {@link Radial} at the given distance and direction.
-     * @param distance
-     * @param degrees
-     */
-    toTranslated(distance: number, degrees: number): Radial;
-    /**
-     * Creates a new {@link Radial} offset by the given amounts.
-     * @param point
-     */
-    toOffset(point: IPoint): Radial;
-    /**
-     * Converts this radial boundary into a {@link Rectangle}.
-     * @param clip	If true, [()], if false ([]).
-     */
-    toRectangle(clip?: boolean): Rectangle;
-}

package/API/Geometry/Rectangle.d.ts

@@ -1,159 +0,0 @@
-import { IPoint, IRectangle, RectangleExpansion } from './Interfaces';
-import { Point } from './Point';
-import { Radial } from './Radial';
-import { Size } from './Size';
-/**
- * A four-sided box on a flat surface.
- */
-export declare class Rectangle implements IRectangle {
-    #private;
-    /**
-     * Returns a new {@link Radial} from the given object.
-     */
-    static fromJSON(rectangle: any): Rectangle;
-    /**
-     * Left-most horizontal coordinate
-     */
-    left: number;
-    /**
-     * Highest vertical coordinate.
-     */
-    top: number;
-    /**
-     * Right-most horizontal coordinate
-     */
-    right: number;
-    /**
-     * Lowest vertical coordinate
-     */
-    bottom: number;
-    /**
-     * The absolute width of this Rectangle.
-     */
-    get width(): number;
-    /**
-     * The absolute height of this Rectangle.
-     */
-    get height(): number;
-    constructor(left?: number | RectangleExpansion, top?: number | RectangleExpansion, right?: number | RectangleExpansion, bottom?: number | RectangleExpansion);
-    /**
-     * Validates the boundary and returns a string representation
-     * @param delimiter	The boundary is delimited by a comma (,) by default, but you can override with your own value (optional)
-     * @returns A string in the format of "left,top,right,bottom".
-     */
-    toString(delimiter?: string): string;
-    /**
-     * Creates a literal of this {@link Rectangle}.
-     * Used internally by {@link JSON.stringify}.
-     */
-    toJSON(): IRectangle;
-    /**
-     * Compares this Rectangle to another to see if they are equal.
-     * @param rect	The other Rectangle to compare.
-     * @param precision	The degree of precision to use; default is full precision.
-     */
-    isEqual(rect: IRectangle, precision?: number): rect is IRectangle;
-    /**
-     * Checks to see if the bounds are valid (not inside-out).
-     */
-    isValid(): boolean;
-    /**
-     * Checks to see if the bounds are valid, and that the corners are different coordinates.
-     */
-    isEmpty(): boolean;
-    /**
-     * Determines if the given {@link IPoint} is contained by this {@link Rectangle}.
-     * @param dot
-     */
-    contains(dot: IPoint): boolean;
-    /**
-     * Determines if the given {@link IRectangle} is overlaps this {@link Rectangle} in any way
-     * @param rect
-     */
-    overlaps(rect: IRectangle): boolean;
-    /**
-     * Validates the boundary and creates a duplicate of this {@link Rectangle}.
-     */
-    copy(): Rectangle;
-    /**
-     * Returns the {@link Point} at the centre.
-     */
-    getCentre(): Point;
-    /**
-     * Validates the boundary and creates a {@link Size} representation.
-     */
-    getSize(): Size;
-    /**
-     * Returns the {@link Point} at the top-most/left-most corner.
-     */
-    getTopLeft(): Point;
-    /**
-     * Returns the {@link Point} at the top-most/right-most corner.
-     */
-    getTopRight(): Point;
-    /**
-     * Returns the {@link Point} at the bottom-most/left-most corner.
-     */
-    getBottomLeft(): Point;
-    /**
-     * Returns the {@link Point} at the bottom-most/right-most corner.
-     */
-    getBottomRight(): Point;
-    /**
-     * Validates the boundary by ensuring the top value is less than the bottom value,
-     * and the left value is less than the right value.
-     * Also adjusts the width and height values.
-     */
-    validate(): this;
-    /**
-     * Extends the boundary to envelop the given point(s) but does not automatically validate.
-     * This comes in efficient when doing many operations on a single {@link Rectangle}.
-     * @param object	The objects used to extend the boundary
-     */
-    expand(object: RectangleExpansion): this;
-    /**
-     * Extends the boundary to envelop the given point(s) and automatically validates
-     * @param object	The objects used to extend the boundary
-     */
-    extend(object: RectangleExpansion): this;
-    /**
-     * Increases the size of the boundary by the given width and height.
-     * If the direction contains the word "top", the {@link Rectangle#top} decreases by the given height.
-     * If the direction contains the word "bottom", the {@link Rectangle#bottom} increases by the given height.
-     * If the direction does not contain either "top" or "bottom", the {@link Rectangle#top} decreases by half the given height, and the {@link Rectangle#bottom} increases by half the given height.
-     * If the direction contains the word "left", the {@link Rectangle#left} decreases by the given width.
-     * If the direction contains the word "right", the {@link Rectangle#right} increases by the given width.
-     * If the direction does not contain either "left" or "right", the {@link Rectangle#left} decreases by half the given width, and the {@link Rectangle#right} increases by half the given height.
-     * @param width
-     * @param height
-     * @param direction
-     */
-    grow(width?: number, height?: number, direction?: string): this;
-    /**
-     * Updates this {@link Rectangle} with the given angle and distance.
-     * @param distance
-     * @param degrees
-     */
-    translateTo(distance: number, degrees: number): this;
-    /**
-     * Updates this {@link Rectangle} with the given offset.
-     * @param dot
-     */
-    offsetTo(dot: IPoint): this;
-    /**
-     * Creates a new {@link Rectangle} at the given angle and distance.
-     * @param distance
-     * @param degrees
-     */
-    toTranslated(distance: number, degrees: number): Rectangle;
-    /**
-     * Creates a new {@link Rectangle} offset by the given amounts.
-     * @param dot
-     */
-    toOffset(dot: IPoint): Rectangle;
-    /**
-     * Validates the boundary and returns a {@link Radial}.
-     * @param clip	If true, [()], if false ([]).
-     */
-    toRadial(clip?: boolean): Radial;
-}

package/API/Geometry/Size.d.ts

@@ -1,58 +0,0 @@
-import { JsonObject } from '../Types';
-import { ISize } from './Interfaces';
-/**
- * Dimensions on a flat surface.
- */
-export declare class Size implements ISize {
-    /**
-     *
-     * @param json
-     * @returns
-     */
-    static fromJSON(json: ISize | JsonObject): Size;
-    /**
-     * Width.
-     */
-    width: number;
-    /**
-     * Height.
-     */
-    height: number;
-    constructor(width: number, height: number);
-    /**
-     * Returns a string representation.
-     * @param delimiter The boundary is delimited by a comma (,) by default, but you can override with your own value.
-     * @returns A string in the format of "width,height".
-     */
-    toString(delimiter?: string): string;
-    /**
-     * Creates a literal of this {@link Size}.
-     * Used internally by {@link JSON.stringify}.
-     */
-    toJSON(): ISize;
-    /**
-     * Compares this Size to another to see if they are equal
-     * @param size		The other Size to compare
-     * @param precision	The degree of precision to use; default is full precision
-     */
-    isEqual(size: ISize, precision?: number): size is ISize;
-    /**
-     * Returns a new instance of a {@link Size} where the width and height are adjusted to the given ratios.
-     * If the second ratio is not given, then the first value is used for both.
-     * The ratios are given as a percentage between 0 and 1.
-     * To double the size of the Size, give a ratio of 2, and to shrink it to half size use 0.5.
-     * @param ratioX
-     * @param ratioY
-     */
-    resize(ratioX?: number, ratioY?: number): Size;
-    /**
-     * Returns a new {@link Size} where the width is the same as the given value, and the height is resized to preserve aspect ratio.
-     * @param width
-     */
-    resizeToWidth(width: number): Size;
-    /**
-     * Returns a new {@link Size} where the height is the same as the given value, and the width is resized to preserve aspect ratio.
-     * @param height
-     */
-    resizeToHeight(height: number): Size;
-}

package/API/Interfaces/IAmCompany.d.ts

@@ -1,11 +0,0 @@
-import { ulong } from '../Types';
-import { IIdUlong } from './IIdUlong';
-/**
- * An interface for all the Company___ classes.
-*/
-export interface IAmCompany extends IIdUlong {
-    /**
-     * The {@link Company} to which this {@link Company} belongs.
-     */
-    parentId: ulong;
-}

package/API/Interfaces/IAuditable.d.ts

@@ -1,31 +0,0 @@
-/**
- * For auditable objects, a record of who and what mad the changes.
-*/
-export interface IAuditable {
-    /**
-     * Details about the change to an object.
-     */
-    updated: IAuditableUpdated;
-    /**
-     * When the was change procesed.
-     */
-    processedUtc: Date;
-}
-/**
- * This class used in conjunction with the {@link version} member help with synchronization.
-*/
-export declare class IAuditableUpdated {
-    /**
-     * The {@link User.login} or {@link Machine.key} when the object is updated,
-     * or {@link Service.UserAgent} if a service updates the object itself.
-     */
-    by: string;
-    /**
-     * A {@link Service.UserAgent} that handled the update.
-     */
-    from: string;
-    /**
-     * Timestamp from when the change was made.
-     */
-    dts: Date;
-}

package/API/Interfaces/IBelongAsset.d.ts

@@ -1,15 +0,0 @@
-import { Asset } from "../../Assets/Asset";
-import { ulong } from "../Types";
-/**
- * An interface for objects that belong to a single asset.
-*/
-export interface IBelongAsset {
-    /**
-     * The {@link Asset.id} to which this object belongs.
-     */
-    assetId: ulong;
-    /**
-     * The {@link Asset} to which this object belongs.
-     */
-    get asset(): Asset;
-}

package/API/Interfaces/IBelongBillingProfile.d.ts

@@ -1,15 +0,0 @@
-import { BillingProfile } from "../../Billing/BillingProfile";
-import { ulong } from "../Types";
-/**
- * An interface for objects that belong to a single billing profile.
-*/
-export interface IBelongBillingProfile {
-    /**
-     * The {@link BillingProfile} to which this object belongs.
-     */
-    get profileId(): ulong;
-    /**
-     * The {@link BillingProfile} to which this object belongs.
-     */
-    readonly profile: BillingProfile;
-}

package/API/Interfaces/IBelongCompany.d.ts

@@ -1,15 +0,0 @@
-import { ulong } from "../Types";
-import { Company } from "../../Companies/Company";
-/**
- * An interface for objects that belong to a single company.
-*/
-export interface IBelongCompany {
-    /**
-     * The {@link Company} to which this object belongs.
-     */
-    get companyId(): ulong;
-    /**
-     * The {@link Company} to which this object belongs.
-     */
-    get company(): Company;
-}

package/API/Interfaces/IDeserializable.d.ts

@@ -1,13 +0,0 @@
-import { JsonObject } from "../../API/Types";
-/**
- * An interface for types that are updated using JSON values.
- */
-export interface IDeserializable {
-    /**
-     * Updates this {@link IDeserializable} from the given input.
-     * @param json      A JSON value used to update this class.
-     * @param forced    When true, forces the update.
-     * @returns True when an update was completed.
-     */
-    fromJSON(json: JsonObject, force?: boolean): boolean;
-}

package/API/Interfaces/IEnabled.d.ts

@@ -1,10 +0,0 @@
-/**
- * An interface for objects that can be marked as "enabled".
- * "Enabled" objects remain in the system, but are inactive.
-*/
-export interface IEnabled {
-    /**
-     * Marked as true for objects that have been deleted.
-     */
-    enabled: boolean;
-}

package/API/Interfaces/IFileSize.d.ts

@@ -1,9 +0,0 @@
-/**
- * An interface for an object's size on a disk.
-*/
-export interface IFileSize {
-    /**
-     * Size (in bytes) of the object on the HDD or SSD.
-     */
-    bytes: number;
-}

package/API/Interfaces/IGlobal.d.ts

@@ -1,11 +0,0 @@
-import { IBelongCompany } from './IBelongCompany';
-/**
- * An interface for objects that can be marked as "global".
- * "Global" objects can be listed in child companies.
-*/
-export interface IGlobal extends IBelongCompany {
-    /**
-     * Indicates whether this icon is available to child companies.
-     */
-    global: boolean;
-}

package/API/Interfaces/IHavePermissions.d.ts

@@ -1,20 +0,0 @@
-import { Permission } from '../../Accounts/Permissions/Permission';
-import { UserGroup } from '../../Accounts/UserGroup';
-import { ulong } from '../Types';
-/**
- * This interface exists so that I can work with Machine and UserAdvanced objects the same way.
-*/
-export interface IHavePermissions {
-    /**
-     * A list of groups to which this object.
-     */
-    get groups(): UserGroup[];
-    /**
-     * A list of groups to which this object.
-     */
-    groupIds: ulong[];
-    /**
-     * Permission rules which override the group rules.
-     */
-    permissions: Permission[];
-}