typia 7.0.0-dev.20241012 → 7.0.0-dev.20241019

package/lib/tags/Example.d.ts

@@ -1,6 +1,6 @@
 import { TagBase } from "./TagBase";
-export type Example<Value extends boolean | bigint | number | string | Array<unknown> | null> = TagBase<{
-    target: "boolean" | "bigint" | "number" | "string" | "array";
+export type Example<Value extends boolean | bigint | number | string | object | Array<unknown> | null> = TagBase<{
+    target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
     kind: "example";
     value: Value;
     exclusive: true;

package/lib/tags/Examples.d.ts

@@ -1,6 +1,6 @@
 import { TagBase } from "./TagBase";
-export type Examples<Dict extends Record<string, boolean | bigint | number | string | Array<unknown> | null>> = TagBase<{
-    target: "boolean" | "bigint" | "number" | "string" | "array";
+export type Examples<Dict extends Record<string, boolean | bigint | number | string | object | Array<unknown> | null>> = TagBase<{
+    target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
     kind: "examples";
     value: Dict;
     exclusive: true;

package/lib/tags/JsonSchemaPlugin.d.ts

@@ -1,6 +1,6 @@
 import { TagBase } from "./TagBase";
 export type JsonSchemaPlugin<Schema extends object> = TagBase<{
-    target: "string" | "boolean" | "bigint" | "number" | "array";
+    target: "string" | "boolean" | "bigint" | "number" | "array" | "object";
     kind: "jsonPlugin";
     value: undefined;
     schema: Schema;

package/lib/tags/Sequence.d.ts

@@ -0,0 +1,9 @@
+import { TagBase } from "./TagBase";
+export type Sequence<N extends number> = TagBase<{
+    target: "boolean" | "bigint" | "number" | "string" | "array" | "object";
+    kind: "sequence";
+    value: N;
+    schema: {
+        "x-protobuf-sequence": N;
+    };
+}>;

package/lib/tags/Sequence.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Sequence.js.map

package/lib/tags/Sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sequence.js","sourceRoot":"","sources":["../../src/tags/Sequence.ts"],"names":[],"mappings":""}

package/lib/tags/TagBase.d.ts

@@ -7,7 +7,7 @@ export type TagBase<Props extends TagBase.IProps<any, any, any, any, any, any>>
     "typia.tag"?: Props;
 };
 export declare namespace TagBase {
-    interface IProps<Target extends "boolean" | "bigint" | "number" | "string" | "array", Kind extends string, Value extends boolean | bigint | number | string | undefined, Validate extends string | {
+    interface IProps<Target extends "boolean" | "bigint" | "number" | "string" | "array" | "object", Kind extends string, Value extends boolean | bigint | number | string | undefined, Validate extends string | {
         [key in Target]?: string;
     }, Exclusive extends boolean | string[], Schema extends object | undefined> {
         /**

package/lib/tags/index.d.ts

@@ -15,6 +15,7 @@ export * from "./MinItems";
 export * from "./MinLength";
 export * from "./MultipleOf";
 export * from "./Pattern";
+export * from "./Sequence";
 export * from "./TagBase";
 export * from "./Type";
 export * from "./UniqueItems";

package/lib/tags/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./MinItems"), exports);
 __exportStar(require("./MinLength"), exports);
 __exportStar(require("./MultipleOf"), exports);
 __exportStar(require("./Pattern"), exports);
+__exportStar(require("./Sequence"), exports);
 __exportStar(require("./TagBase"), exports);
 __exportStar(require("./Type"), exports);
 __exportStar(require("./UniqueItems"), exports);

package/lib/tags/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tags/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC;AACnC,4CAA0B;AAC1B,4CAA0B;AAC1B,6CAA2B;AAC3B,qDAAmC;AACnC,qDAAmC;AACnC,2CAAyB;AACzB,qDAAmC;AACnC,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,4CAA0B;AAC1B,4CAA0B;AAC1B,yCAAuB;AACvB,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tags/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,qDAAmC;AACnC,4CAA0B;AAC1B,4CAA0B;AAC1B,6CAA2B;AAC3B,qDAAmC;AACnC,qDAAmC;AACnC,2CAAyB;AACzB,qDAAmC;AACnC,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,4CAA0B;AAC1B,6CAA2B;AAC3B,8CAA4B;AAC5B,+CAA6B;AAC7B,4CAA0B;AAC1B,6CAA2B;AAC3B,4CAA0B;AAC1B,yCAAuB;AACvB,gDAA8B"}

package/lib/utils/{NameEncoder.d.ts → ProtobufNameEncoder.d.ts}

@@ -1,4 +1,4 @@
-export declare namespace NameEncoder {
+export declare namespace ProtobufNameEncoder {
     const encode: (str: string) => string;
     const decode: (str: string) => string;
 }

package/lib/utils/{NameEncoder.js → ProtobufNameEncoder.js}

@@ -27,10 +27,10 @@ var __read = (this && this.__read) || function (o, n) {
     return ar;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NameEncoder = void 0;
-var NameEncoder;
-(function (NameEncoder) {
-    NameEncoder.encode = function (str) {
+exports.ProtobufNameEncoder = void 0;
+var ProtobufNameEncoder;
+(function (ProtobufNameEncoder) {
+    ProtobufNameEncoder.encode = function (str) {
         var e_1, _a;
         try {
             for (var REPLACERS_1 = __values(REPLACERS), REPLACERS_1_1 = REPLACERS_1.next(); !REPLACERS_1_1.done; REPLACERS_1_1 = REPLACERS_1.next()) {
@@ -47,7 +47,7 @@ var NameEncoder;
         }
         return str;
     };
-    NameEncoder.decode = function (str) {
+    ProtobufNameEncoder.decode = function (str) {
         var e_2, _a;
         try {
             for (var REPLACERS_2 = __values(REPLACERS), REPLACERS_2_1 = REPLACERS_2.next(); !REPLACERS_2_1.done; REPLACERS_2_1 = REPLACERS_2.next()) {
@@ -65,7 +65,7 @@ var NameEncoder;
         }
         return str;
     };
-})(NameEncoder || (exports.NameEncoder = NameEncoder = {}));
+})(ProtobufNameEncoder || (exports.ProtobufNameEncoder = ProtobufNameEncoder = {}));
 var REPLACERS = [
     ["$", "_dollar_"],
     ["&", "_and_"],
@@ -84,4 +84,4 @@ var REPLACERS = [
     ['"', "_doublequote_"],
     [" ", "_space_"],
 ];
-//# sourceMappingURL=NameEncoder.js.map
+//# sourceMappingURL=ProtobufNameEncoder.js.map

package/lib/utils/ProtobufNameEncoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProtobufNameEncoder.js","sourceRoot":"","sources":["../../src/utils/ProtobufNameEncoder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAiB,mBAAmB,CAYnC;AAZD,WAAiB,mBAAmB;IACrB,0BAAM,GAAG,UAAC,GAAW;;;YAChC,KAA8B,IAAA,cAAA,SAAA,SAAS,CAAA,oCAAA;gBAA5B,IAAA,KAAA,8BAAe,EAAd,MAAM,QAAA,EAAE,KAAK,QAAA;gBACvB,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aAAA;;;;;;;;;QACtC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEW,0BAAM,GAAG,UAAC,GAAW;;;YAChC,KAA8B,IAAA,cAAA,SAAA,SAAS,CAAA,oCAAA;gBAA5B,IAAA,KAAA,8BAAe,EAAd,MAAM,QAAA,EAAE,KAAK,QAAA;gBACvB,IAAI,KAAK,KAAK,EAAE;oBAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aAAA;;;;;;;;;QACxD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;AACJ,CAAC,EAZgB,mBAAmB,mCAAnB,mBAAmB,QAYnC;AAED,IAAM,SAAS,GAAuB;IACpC,CAAC,GAAG,EAAE,UAAU,CAAC;IACjB,CAAC,GAAG,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,SAAS,CAAC;IAChB,CAAC,GAAG,EAAE,aAAa,CAAC;IACpB,CAAC,GAAG,EAAE,eAAe,CAAC;IACtB,CAAC,GAAG,EAAE,eAAe,CAAC;IACtB,CAAC,GAAG,EAAE,SAAS,CAAC;CACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typia",
-  "version": "7.0.0-dev.20241012",
+  "version": "7.0.0-dev.20241019",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/src/factories/JsonMetadataFactory.ts

@@ -66,8 +66,11 @@ export namespace JsonMetadataFactory {
     if (meta.maps.length) output.push("JSON does not support Map type.");
     if (meta.sets.length) output.push("JSON does not support Set type.");
     for (const native of meta.natives)
-      if (AtomicPredicator.native(native) === false && native !== "Date")
-        output.push(`JSON does not support ${native} type.`);
+      if (
+        AtomicPredicator.native(native.name) === false &&
+        native.name !== "Date"
+      )
+        output.push(`JSON does not support ${native.name} type.`);
     return output;
   };
 }

package/src/factories/MetadataCollection.ts

@@ -2,7 +2,7 @@ import ts from "typescript";
 
 import { IMetadataComponents } from "../schemas/metadata/IMetadataComponents";
 import { Metadata } from "../schemas/metadata/Metadata";
-import { MetadataAlias } from "../schemas/metadata/MetadataAlias";
+import { MetadataAliasType } from "../schemas/metadata/MetadataAliasType";
 import { MetadataArrayType } from "../schemas/metadata/MetadataArrayType";
 import { MetadataObjectType } from "../schemas/metadata/MetadataObjectType";
 import { MetadataTupleType } from "../schemas/metadata/MetadataTupleType";
@@ -17,7 +17,7 @@ import { TypeFactory } from "./TypeFactory";
 export class MetadataCollection {
   private objects_: Map<ts.Type, MetadataObjectType>;
   private object_unions_: Map<string, MetadataObjectType[]>;
-  private aliases_: Map<ts.Type, MetadataAlias>;
+  private aliases_: Map<ts.Type, MetadataAliasType>;
   private arrays_: Map<ts.Type, MetadataArrayType>;
   private tuples_: Map<ts.Type, MetadataTupleType>;
 
@@ -58,7 +58,7 @@ export class MetadataCollection {
   /* -----------------------------------------------------------
         ACCESSORS
     ----------------------------------------------------------- */
-  public aliases(): MetadataAlias[] {
+  public aliases(): MetadataAliasType[] {
     return [...this.aliases_.values()];
   }
 
@@ -146,12 +146,12 @@ export class MetadataCollection {
     checker: ts.TypeChecker,
     type: ts.Type,
     symbol: ts.Symbol,
-  ): [MetadataAlias, boolean, (meta: Metadata) => void] {
+  ): [MetadataAliasType, boolean, (meta: Metadata) => void] {
     const oldbie = this.aliases_.get(type);
     if (oldbie !== undefined) return [oldbie, false, () => {}];
 
     const $id: string = this.getName(checker, type);
-    const alias: MetadataAlias = MetadataAlias.create({
+    const alias: MetadataAliasType = MetadataAliasType.create({
       name: $id,
       value: null!,
       description: CommentFactory.description(symbol) ?? null,
@@ -211,7 +211,7 @@ export class MetadataCollection {
   /**
    * @internal
    */
-  public setAliasRecursive(alias: MetadataAlias, recursive: boolean): void {
+  public setAliasRecursive(alias: MetadataAliasType, recursive: boolean): void {
     Writable(alias).recursive = recursive;
   }
 

package/src/factories/MetadataFactory.ts

@@ -1,7 +1,7 @@
 import ts from "typescript";
 
 import { Metadata } from "../schemas/metadata/Metadata";
-import { MetadataAlias } from "../schemas/metadata/MetadataAlias";
+import { MetadataAliasType } from "../schemas/metadata/MetadataAliasType";
 import { MetadataArrayType } from "../schemas/metadata/MetadataArrayType";
 import { MetadataConstant } from "../schemas/metadata/MetadataConstant";
 import { MetadataFunction } from "../schemas/metadata/MetadataFunction";
@@ -39,7 +39,7 @@ export namespace MetadataFactory {
     top: boolean;
     object: MetadataObjectType | null;
     property: string | object | null;
-    nested: null | MetadataAlias | MetadataArrayType | MetadataTupleType;
+    nested: null | MetadataAliasType | MetadataArrayType | MetadataTupleType;
     parameter: string | null;
     output: boolean;
     escaped: boolean;
@@ -107,7 +107,7 @@ export namespace MetadataFactory {
         values: [
           {
             value,
-            tags: undefined,
+            tags: [],
           },
         ],
         type: "string",
@@ -186,7 +186,7 @@ export namespace MetadataFactory {
     for (const alias of props.metadata.aliases)
       validateAlias({
         ...props,
-        alias,
+        alias: alias.type,
       });
     for (const array of props.metadata.arrays)
       validateArray({
@@ -211,7 +211,7 @@ export namespace MetadataFactory {
     for (const set of props.metadata.sets)
       validateMeta({
         ...props,
-        metadata: set,
+        metadata: set.value,
       });
     for (const map of props.metadata.maps) {
       validateMeta({
@@ -239,7 +239,7 @@ export namespace MetadataFactory {
     transformer?: ts.TransformationContext;
     options: IOptions;
     visitor: IValidationVisitor;
-    alias: MetadataAlias;
+    alias: MetadataAliasType;
     explore: IExplore;
   }) => {
     if (props.visitor.aliases.has(props.alias)) return;
@@ -400,7 +400,7 @@ export namespace MetadataFactory {
     objects: Set<MetadataObjectType>;
     arrays: Set<MetadataArrayType>;
     tuples: Set<MetadataTupleType>;
-    aliases: Set<MetadataAlias>;
+    aliases: Set<MetadataAliasType>;
     functions: Set<MetadataFunction>;
   }
 }

package/src/factories/MetadataTypeTagFactory.ts

@@ -7,9 +7,33 @@ import { MetadataFactory } from "./MetadataFactory";
 import { MetadataTypeTagSchemaFactory } from "./MetadataTypeTagSchemaFactory";
 
 export namespace MetadataTypeTagFactory {
+  export const is = (obj: MetadataObjectType): boolean => {
+    if (obj.properties.length !== 1) return false;
+
+    const top: MetadataProperty = obj.properties[0]!;
+    if (top.key.isSoleLiteral() === false) return false;
+    else if (top.key.getSoleLiteral() !== "typia.tag") return false;
+
+    const value: Metadata = top.value;
+    if (
+      value.size() !== 1 ||
+      value.objects.length !== 1 ||
+      value.isRequired() === true ||
+      value.nullable === true
+    )
+      return false;
+
+    const tag: MetadataObjectType = top.value.objects[0]!.type;
+    const statics: string[] = tag.properties
+      .map((p) => p.key.getSoleLiteral()!)
+      .filter((str) => str !== null);
+    if (ESSENTIAL_FIELDS.some((f) => !statics.includes(f))) return false;
+    return true;
+  };
+
   export const analyze = (props: {
     errors: MetadataFactory.IError[];
-    type: "boolean" | "bigint" | "number" | "string" | "array";
+    type: "boolean" | "bigint" | "number" | "string" | "array" | "object";
     objects: MetadataObjectType[];
     explore: MetadataFactory.IExplore;
   }): IMetadataTypeTag[] => {
@@ -120,7 +144,7 @@ export namespace MetadataTypeTagFactory {
 
   export const validate = (props: {
     report: (next: { property: string | null; message: string }) => false;
-    type: "boolean" | "bigint" | "number" | "string" | "array";
+    type: "boolean" | "bigint" | "number" | "string" | "array" | "object";
     tags: IMetadataTypeTag[];
   }): boolean => {
     let success: boolean = true;
@@ -176,12 +200,13 @@ export namespace MetadataTypeTagFactory {
             v.value !== "bigint" &&
             v.value !== "number" &&
             v.value !== "string" &&
-            v.value !== "array",
+            v.value !== "array" &&
+            v.value !== "object",
         ))
     )
       return props.report({
         property: props.key,
-        message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array'`,
+        message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array', 'object'`,
       });
     else if (
       // KIND
@@ -237,7 +262,7 @@ export namespace MetadataTypeTagFactory {
       if (target === undefined)
         return props.report({
           property: "target",
-          message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array'`,
+          message: `must be one of 'boolean', 'bigint', 'number', 'string', 'array', 'object`,
         });
       const variadic: boolean =
         props.value.size() === 1 &&
@@ -374,7 +399,7 @@ export namespace MetadataTypeTagFactory {
 
 interface ITypeTag {
   name: string;
-  target: Array<"bigint" | "number" | "string" | "array">;
+  target: Array<"bigint" | "number" | "string" | "array" | "object">;
   kind: string;
   value?: undefined | boolean | bigint | number | string;
   validate: Record<string, string>;