@trakit/objects 0.0.6 → 0.0.8

package/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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/_publish/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[];
-}

package/_publish/API/Interfaces/IHavePreferences.d.ts

@@ -1,29 +0,0 @@
-import { SystemsOfUnits } from '../../Accounts/SystemsOfUnits';
-import { Timezone } from '../Timezone';
-import { codified } from '../Types';
-/**
- * This interface exists so that I can work with Machine and UserGeneral objects the same way.
-*/
-export interface IHavePreferences {
-    /**
-     * The local timezone for this object.
-     */
-    timezone: Timezone;
-    /**
-     * Preferred region/language for the UI and notifications.
-     * Valid formats use <ISO 639-1><dash><ISO 3166-2> such as "fr-CA" or "en-US".
-     */
-    language: codified;
-    /**
-     * The format strings defining the preferred way to display ambiguous values.
-     */
-    formats: Map<codified, string>;
-    /**
-     * Preferred way of displaying ambiguous numbers in the context of measurements.
-     */
-    measurements: Map<codified, SystemsOfUnits>;
-    /**
-     * Additional options which do not fit in with the formats or measurements preferences.
-     */
-    options: Map<codified, string>;
-}

package/_publish/API/Interfaces/IIconic.d.ts

@@ -1,15 +0,0 @@
-import { Icon } from '../../Images/Icon';
-import { ulong } from '../Types';
-/**
- * An interface for objcts that have an "icon".
-*/
-export interface IIconic {
-    /**
-     * This thing's {@link Icon.id}.
-     */
-    iconId: ulong;
-    /**
-     * This thing's {@link Icon}.
-     */
-    get icon(): Icon;
-}

package/_publish/API/Interfaces/IIdUlong.d.ts

@@ -1,10 +0,0 @@
-import { ulong } from '../Types';
-/**
- * An interface for objects with a ulong "id".
-*/
-export interface IIdUlong {
-    /**
-     * Unique identifier of this object.
-     */
-    id: ulong;
-}

package/_publish/API/Interfaces/ILabelled.d.ts

@@ -1,10 +0,0 @@
-import { codified } from "../Types";
-/**
- * An interface for objects that have "labels".
-*/
-export interface ILabelled {
-    /**
-     * A list of codified labels for this asset or place.
-     */
-    labels: codified[];
-}

package/_publish/API/Interfaces/INamed.d.ts

@@ -1,13 +0,0 @@
-/**
- * An interface for objects that have a "name" and "notes".
-*/
-export interface INamed {
-    /**
-     * This thing's name.
-     */
-    name: string;
-    /**
-     * This thing's notes.
-     */
-    notes: string;
-}

package/_publish/API/Interfaces/IPictured.d.ts

@@ -1,15 +0,0 @@
-import { ulong } from '../Types';
-import { Picture } from '../../Images/Picture';
-/**
- * An interface for objects that have "pictures".
-*/
-export interface IPictured {
-    /**
-     * An array of picture identifiers of this object.
-     */
-    pictureIds: ulong[];
-    /**
-     * An array of {@link Picture}s of this object.
-     */
-    get pictures(): Picture[];
-}

package/_publish/API/Interfaces/IRequestable.d.ts

@@ -1,22 +0,0 @@
-import { email, guid, ulong } from "../Types";
-/**
- * The main interface for an object in the Trak-iT system.
-*/
-export interface IRequestable {
-    /**
-     * Returns a unique identifier as a string.
-     * {@link Dashcam.guid}
-     * {@link IIdUlong.id}
-     * {@link Machine.key}
-     * {@link Provider.id}
-     * {@link ProviderGeneral.id}
-     * {@link ProviderAdvanced.id}
-     * {@link ProviderControl.id}
-     * {@link ProviderRegistration.code}
-     * {@link User.login}
-     * {@link UserGeneral.login}
-     * {@link UserAdvanced.login}
-     * {@link Timezone.code}
-     */
-    getKey(): ulong | email | guid | string;
-}

package/_publish/API/Interfaces/ISerializable.d.ts

@@ -1,10 +0,0 @@
-/**
- * An interface for types that can be converted to JSON for transmission or storage.
- */
-export interface ISerializable {
-    /**
-     * Creates a literal of this {@link ISerializable} object.
-     * Used internally by {@link JSON.stringify}.
-     */
-    toJSON(): any;
-}

package/_publish/API/Interfaces/ISuspendable.d.ts

@@ -1,16 +0,0 @@
-/**
- * An interface for objects that can be marked as "suspended".
- * "Suspended" objects can be "revived", but are otherwise treated as "achived" or "inert" (events are not processed).
-*/
-export interface ISuspendable {
-    /**
-     * Marked as true for objects that have been suspended.
-     * This value is not present in the JSON scheme when {@link deleted} is false.
-     */
-    suspended?: boolean;
-    /**
-     * A timestamp from when the object was most recently suspended or revived.
-     * This value is not present in the JSON scheme when {@link suspended} is false.
-     */
-    since?: Date;
-}

package/_publish/API/Interfaces/IVisual.d.ts

@@ -1,18 +0,0 @@
-import { codified, colour } from "../Types";
-/**
- * An interface for objects that make them more easily visually identifiable.
-*/
-export interface IVisual {
-    /**
-     * The background colour of the graphic.
-     */
-    fill: colour;
-    /**
-     * Outline and graphic colour.
-     */
-    stroke: colour;
-    /**
-     * The name of the symbol for this object.
-     */
-    graphic: codified;
-}

package/_publish/API/Objects.d.ts

@@ -1,5 +0,0 @@
-/**
- * Used internally by {@link MERGE}.
- * @param value
- */
-export declare function MERGE_INTERNAL(value: any): any;