typia 3.3.12 → 3.4.0-dev.20221212

package/src/functional/$report.ts

@@ -0,0 +1,15 @@
+import { IValidation } from "../IValidation";
+
+export const $report = (array: IValidation.IError[]) => {
+    const reportable = (path: string): boolean => {
+        if (array.length === 0) return true;
+        const last: string = array[array.length - 1]!.path;
+        return (
+            path.length > last.length || last.substring(0, path.length) !== path
+        );
+    };
+    return (exceptable: boolean, error: IValidation.IError): false => {
+        if (exceptable && reportable(error.path)) array.push(error);
+        return false;
+    };
+};

package/src/functional/$rest.ts

@@ -0,0 +1,3 @@
+export function $rest(str: string): string {
+    return str.length === 2 ? "" : "," + str.substring(1, str.length - 1);
+}

package/src/functional/$string.ts

@@ -0,0 +1,37 @@
+/**
+ * @internal
+ */
+export function $string(str: string): string {
+    if (str.length > 41) return JSON.stringify(str);
+
+    const length = str.length;
+    let result = "";
+    let last = 0;
+    let found = false;
+    let surrogateFound = false;
+    let point = 255;
+
+    // eslint-disable-next-line
+    for (let i = 0; i < length && point >= 32; i++) {
+        point = str.charCodeAt(i);
+        if (0xd800 <= point && point <= 0xdfff) {
+            // The current character is a surrogate.
+            surrogateFound = true;
+            break;
+        }
+        if (point === 34 || point === 92) {
+            result += str.slice(last, i) + "\\";
+            last = i;
+            found = true;
+        }
+    }
+
+    if (!found) {
+        result = str;
+    } else {
+        result += str.slice(last);
+    }
+    return point < 32 || surrogateFound === true
+        ? JSON.stringify(str)
+        : `"${result}"`;
+}

package/src/functional/$tail.ts

@@ -0,0 +1,6 @@
+/**
+ * @internal
+ */
+export function $tail(str: string): string {
+    return str[str.length - 1] === "," ? str.substring(0, str.length - 1) : str;
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+import * as typia from "./module";
+
+export default typia;
+export * from "./module";

package/src/metadata/IJsDocTagInfo.ts

@@ -0,0 +1,10 @@
+export interface IJsDocTagInfo {
+    name: string;
+    text?: IJsDocTagInfo.IText[];
+}
+export namespace IJsDocTagInfo {
+    export interface IText {
+        text: string;
+        kind: string;
+    }
+}

package/src/metadata/IMetadata.ts

@@ -0,0 +1,25 @@
+import { Atomic } from "../typings/Atomic";
+
+import { IMetadataConstant } from "./IMetadataConstant";
+import { IMetadataEntry } from "./IMetadataEntry";
+
+export interface IMetadata {
+    any: boolean;
+    required: boolean;
+    nullable: boolean;
+    functional: boolean;
+
+    atomics: Atomic.Literal[];
+    constants: IMetadataConstant[];
+    templates: IMetadata[][];
+    resolved: IMetadata | null;
+
+    rest: IMetadata | null;
+    arrays: IMetadata[];
+    tuples: IMetadata[][];
+    objects: string[];
+
+    natives: string[];
+    sets: IMetadata[];
+    maps: IMetadataEntry[];
+}

package/src/metadata/IMetadataApplication.ts

@@ -0,0 +1,7 @@
+import { IMetadata } from "./IMetadata";
+import { IMetadataObject } from "./IMetadataObject";
+
+export interface IMetadataApplication {
+    metadatas: IMetadata[];
+    collection: IMetadataObject[];
+}

package/src/metadata/IMetadataConstant.ts

@@ -0,0 +1,16 @@
+import { Atomic } from "../typings/Atomic";
+
+export type IMetadataConstant =
+    | IMetadataConstant.IBase<"boolean", boolean>
+    | IMetadataConstant.IBase<"number", number>
+    | IMetadataConstant.IBase<"string", string>
+    | IMetadataConstant.IBase<"bigint", bigint>;
+export namespace IMetadataConstant {
+    export interface IBase<
+        Type extends Atomic.Literal,
+        Value extends Atomic.Type,
+    > {
+        type: Type;
+        values: Value[];
+    }
+}

package/src/metadata/IMetadataEntry.ts

@@ -0,0 +1,6 @@
+import { IMetadata } from "./IMetadata";
+
+export interface IMetadataEntry {
+    key: IMetadata;
+    value: IMetadata;
+}

package/src/metadata/IMetadataObject.ts

@@ -0,0 +1,29 @@
+import { IJsDocTagInfo } from "./IJsDocTagInfo";
+import { IMetadataProperty } from "./IMetadataProperty";
+
+export interface IMetadataObject {
+    name: string;
+    properties: IMetadataProperty[];
+    description?: string;
+    jsDocTags: IJsDocTagInfo[];
+
+    /**
+     * @internal
+     */
+    index: number;
+
+    /**
+     * @internal
+     */
+    validated: boolean;
+
+    /**
+     * @internal
+     */
+    recursive: boolean;
+
+    /**
+     * @internal
+     */
+    nullables: boolean[];
+}

package/src/metadata/IMetadataProperty.ts

@@ -0,0 +1,11 @@
+import { IJsDocTagInfo } from "./IJsDocTagInfo";
+import { IMetadata } from "./IMetadata";
+import { IMetadataTag } from "./IMetadataTag";
+
+export interface IMetadataProperty {
+    key: IMetadata;
+    value: IMetadata;
+    description?: string;
+    tags: IMetadataTag[];
+    jsDocTags: IJsDocTagInfo[];
+}

package/src/metadata/IMetadataTag.ts

@@ -0,0 +1,122 @@
+export type IMetadataTag =
+    // ARRAY
+    | IMetadataTag.IItems
+    | IMetadataTag.IMinItems
+    | IMetadataTag.IMaxItems
+    // STRING
+    | IMetadataTag.IFormat
+    | IMetadataTag.IPattern
+    | IMetadataTag.ILength
+    | IMetadataTag.IMinLength
+    | IMetadataTag.IMaxLength
+    // NUMBER
+    | IMetadataTag.IType
+    | IMetadataTag.IRange
+    | IMetadataTag.IMinimum
+    | IMetadataTag.IMaximum
+    | IMetadataTag.IExclusiveMinimum
+    | IMetadataTag.IExclusiveMaximum
+    | IMetadataTag.IMultipleOf
+    | IMetadataTag.IStep;
+
+export namespace IMetadataTag {
+    /* -----------------------------------------------------------
+        ARRAY   
+    ----------------------------------------------------------- */
+    export interface IItems {
+        kind: "items";
+        minimum?: ISign;
+        maximum?: ISign;
+    }
+
+    export interface IMinItems {
+        kind: "minItems";
+        value: number;
+    }
+
+    export interface IMaxItems {
+        kind: "maxItems";
+        value: number;
+    }
+
+    /* -----------------------------------------------------------
+        STRING
+    ----------------------------------------------------------- */
+    export interface IFormat {
+        kind: "format";
+        value: "uuid" | "email" | "url" | "ipv4" | "ipv6";
+    }
+
+    export interface IPattern {
+        kind: "pattern";
+        value: string;
+    }
+
+    export interface ILength {
+        kind: "length";
+        minimum?: ISign;
+        maximum?: ISign;
+    }
+
+    export interface IMinLength {
+        kind: "minLength";
+        value: number;
+    }
+
+    export interface IMaxLength {
+        kind: "maxLength";
+        value: number;
+    }
+
+    /* -----------------------------------------------------------
+        NUMBER
+    ----------------------------------------------------------- */
+    export interface IType {
+        kind: "type";
+        value: "int" | "uint";
+    }
+
+    export interface IRange {
+        kind: "range";
+        minimum?: ISign;
+        maximum?: ISign;
+    }
+
+    export interface IMinimum {
+        kind: "minimum";
+        value: number;
+    }
+
+    export interface IMaximum {
+        kind: "maximum";
+        value: number;
+    }
+
+    export interface IExclusiveMinimum {
+        kind: "exclusiveMinimum";
+        value: number;
+    }
+
+    export interface IExclusiveMaximum {
+        kind: "exclusiveMaximum";
+        value: number;
+    }
+
+    export interface IMultipleOf {
+        kind: "multipleOf";
+        value: number;
+    }
+
+    export interface IStep {
+        kind: "step";
+        value: number;
+    }
+
+    /* -----------------------------------------------------------
+        MISCELLANEOUS
+    ----------------------------------------------------------- */
+    export interface ISign {
+        include: boolean;
+        value: number;
+    }
+}