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

package/src/schemas/metadata/MetadataSet.ts

@@ -0,0 +1,45 @@
+import { ClassProperties } from "../../typings/ClassProperties";
+
+import { IMetadataSet } from "./IMetadataSet";
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+import { Metadata } from "./Metadata";
+
+export class MetadataSet {
+  public readonly value: Metadata;
+  public readonly tags: IMetadataTypeTag[][];
+  private name_?: string;
+
+  private constructor(props: ClassProperties<MetadataSet>) {
+    this.value = props.value;
+    this.tags = props.tags;
+  }
+
+  public static create(props: ClassProperties<MetadataSet>): MetadataSet {
+    return new MetadataSet(props);
+  }
+
+  public getName(): string {
+    return (this.name_ ??= (() => {
+      const symbol: string = `Set<${this.value.getName()}>`;
+      if (this.tags.length === 0) return symbol;
+      else if (this.tags.length === 1) {
+        const str: string = [symbol, ...this.tags[0]!.map((t) => t.name)].join(
+          " & ",
+        );
+        return `(${str})`;
+      }
+      const rows: string[] = this.tags.map((row) => {
+        const str: string = row.map((t) => t.name).join(" & ");
+        return row.length === 1 ? str : `(${str})`;
+      });
+      return `(${symbol} & (${rows.join(" | ")}))`;
+    })());
+  }
+
+  public toJSON(): IMetadataSet {
+    return {
+      value: this.value.toJSON(),
+      tags: this.tags,
+    };
+  }
+}

package/src/schemas/metadata/MetadataTemplate.ts

@@ -1,80 +1,80 @@
-import { ClassProperties } from "../../typings/ClassProperties";
-
-import { IMetadataDictionary } from "./IMetadataDictionary";
-import { IMetadataTemplate } from "./IMetadataTemplate";
-import { IMetadataTypeTag } from "./IMetadataTypeTag";
-import { Metadata } from "./Metadata";
-
-export class MetadataTemplate {
-  public readonly row: Metadata[];
-  public tags: IMetadataTypeTag[][] | undefined;
-
-  private name_?: string;
-
-  private constructor(props: ClassProperties<MetadataTemplate>) {
-    this.row = props.row.map(Metadata.create);
-    this.tags = props.tags;
-  }
-
-  public static create(
-    props: ClassProperties<MetadataTemplate>,
-  ): MetadataTemplate {
-    return new MetadataTemplate(props);
-  }
-
-  public static from(
-    json: IMetadataTemplate,
-    dict: IMetadataDictionary,
-  ): MetadataTemplate {
-    return new MetadataTemplate({
-      row: json.row.map((m) => Metadata.from(m, dict)),
-      tags: json.tags,
-    });
-  }
-
-  public getName(): string {
-    return (this.name_ ??= getName(this));
-  }
-
-  /**
-   * @internal
-   */
-  public getBaseName(): string {
-    return (
-      "`" +
-      this.row
-        .map((child) =>
-          child.isConstant() && child.size() === 1
-            ? child.constants[0]!.values[0]!.value
-            : `$\{${child.getName()}\}`,
-        )
-        .join("")
-        .split("`")
-        .join("\\`") +
-      "`"
-    );
-  }
-
-  public toJSON(): IMetadataTemplate {
-    return {
-      row: this.row.map((m) => m.toJSON()),
-      tags: this.tags,
-    };
-  }
-}
-
-const getName = (template: MetadataTemplate): string => {
-  const base: string = template.getBaseName();
-  if (!template.tags?.length) return base;
-  else if (template.tags.length === 1) {
-    const str: string = [base, ...template.tags[0]!.map((t) => t.name)].join(
-      " & ",
-    );
-    return `(${str})`;
-  }
-  const rows: string[] = template.tags.map((row) => {
-    const str: string = row.map((t) => t.name).join(" & ");
-    return row.length === 1 ? str : `(${str})`;
-  });
-  return `(${base} & (${rows.join(" | ")}))`;
-};
+import { ClassProperties } from "../../typings/ClassProperties";
+
+import { IMetadataDictionary } from "./IMetadataDictionary";
+import { IMetadataTemplate } from "./IMetadataTemplate";
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+import { Metadata } from "./Metadata";
+
+export class MetadataTemplate {
+  public readonly row: Metadata[];
+  public readonly tags: IMetadataTypeTag[][];
+
+  private name_?: string;
+
+  private constructor(props: ClassProperties<MetadataTemplate>) {
+    this.row = props.row.map(Metadata.create);
+    this.tags = props.tags;
+  }
+
+  public static create(
+    props: ClassProperties<MetadataTemplate>,
+  ): MetadataTemplate {
+    return new MetadataTemplate(props);
+  }
+
+  public static from(
+    json: IMetadataTemplate,
+    dict: IMetadataDictionary,
+  ): MetadataTemplate {
+    return new MetadataTemplate({
+      row: json.row.map((m) => Metadata.from(m, dict)),
+      tags: json.tags,
+    });
+  }
+
+  public getName(): string {
+    return (this.name_ ??= getName(this));
+  }
+
+  /**
+   * @internal
+   */
+  public getBaseName(): string {
+    return (
+      "`" +
+      this.row
+        .map((child) =>
+          child.isConstant() && child.size() === 1
+            ? child.constants[0]!.values[0]!.value
+            : `$\{${child.getName()}\}`,
+        )
+        .join("")
+        .split("`")
+        .join("\\`") +
+      "`"
+    );
+  }
+
+  public toJSON(): IMetadataTemplate {
+    return {
+      row: this.row.map((m) => m.toJSON()),
+      tags: this.tags,
+    };
+  }
+}
+
+const getName = (template: MetadataTemplate): string => {
+  const base: string = template.getBaseName();
+  if (!template.tags?.length) return base;
+  else if (template.tags.length === 1) {
+    const str: string = [base, ...template.tags[0]!.map((t) => t.name)].join(
+      " & ",
+    );
+    return `(${str})`;
+  }
+  const rows: string[] = template.tags.map((row) => {
+    const str: string = row.map((t) => t.name).join(" & ");
+    return row.length === 1 ? str : `(${str})`;
+  });
+  return `(${base} & (${rows.join(" | ")}))`;
+};

package/src/schemas/metadata/MetadataTuple.ts

@@ -1,32 +1,32 @@
-import { ClassProperties } from "../../typings/ClassProperties";
-
-import { IMetadataTuple } from "./IMetadataTuple";
-import { IMetadataTypeTag } from "./IMetadataTypeTag";
-import { MetadataTupleType } from "./MetadataTupleType";
-
-export class MetadataTuple {
-  public readonly type: MetadataTupleType;
-  public readonly tags: IMetadataTypeTag[][];
-
-  /**
-   * @hidden
-   */
-  private constructor(props: ClassProperties<MetadataTuple>) {
-    this.type = props.type;
-    this.tags = props.tags;
-  }
-
-  /**
-   * @internal
-   */
-  public static create(props: ClassProperties<MetadataTuple>): MetadataTuple {
-    return new MetadataTuple(props);
-  }
-
-  public toJSON(): IMetadataTuple {
-    return {
-      name: this.type.name,
-      tags: this.tags.map((row) => row.slice()),
-    };
-  }
-}
+import { ClassProperties } from "../../typings/ClassProperties";
+
+import { IMetadataTuple } from "./IMetadataTuple";
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+import { MetadataTupleType } from "./MetadataTupleType";
+
+export class MetadataTuple {
+  public readonly type: MetadataTupleType;
+  public readonly tags: IMetadataTypeTag[][];
+
+  /**
+   * @hidden
+   */
+  private constructor(props: ClassProperties<MetadataTuple>) {
+    this.type = props.type;
+    this.tags = props.tags;
+  }
+
+  /**
+   * @internal
+   */
+  public static create(props: ClassProperties<MetadataTuple>): MetadataTuple {
+    return new MetadataTuple(props);
+  }
+
+  public toJSON(): IMetadataTuple {
+    return {
+      name: this.type.name,
+      tags: this.tags.map((row) => row.slice()),
+    };
+  }
+}

package/src/schemas/protobuf/IProtobufProperty.ts

@@ -0,0 +1,6 @@
+import { IProtobufPropertyType } from "./IProtobufPropertyType";
+
+export interface IProtobufProperty {
+  fixed: boolean;
+  union: IProtobufPropertyType[];
+}

package/src/schemas/protobuf/IProtobufPropertyType.ts

@@ -0,0 +1,37 @@
+import { IProtobufSchema } from "./IProtobufSchema";
+
+export type IProtobufPropertyType =
+  | IProtobufPropertyType.IByte
+  | IProtobufPropertyType.IBoolean
+  | IProtobufPropertyType.IBigint
+  | IProtobufPropertyType.INumber
+  | IProtobufPropertyType.IString
+  | IProtobufPropertyType.IArray
+  | IProtobufPropertyType.IObject
+  | IProtobufPropertyType.IMap;
+export namespace IProtobufPropertyType {
+  export interface IByte extends IProtobufSchema.IByte {
+    index: number;
+  }
+  export interface IBoolean extends IProtobufSchema.IBoolean {
+    index: number;
+  }
+  export interface IBigint extends IProtobufSchema.IBigint {
+    index: number;
+  }
+  export interface INumber extends IProtobufSchema.INumber {
+    index: number;
+  }
+  export interface IString extends IProtobufSchema.IString {
+    index: number;
+  }
+  export interface IArray extends IProtobufSchema.IArray {
+    index: number;
+  }
+  export interface IObject extends IProtobufSchema.IObject {
+    index: number;
+  }
+  export interface IMap extends IProtobufSchema.IMap {
+    index: number;
+  }
+}

package/src/schemas/protobuf/IProtobufSchema.ts

@@ -0,0 +1,50 @@
+import { MetadataArrayType } from "../metadata/MetadataArrayType";
+import { MetadataMap } from "../metadata/MetadataMap";
+import { MetadataObjectType } from "../metadata/MetadataObjectType";
+
+export type IProtobufSchema =
+  | IProtobufSchema.IByte
+  | IProtobufSchema.IBoolean
+  | IProtobufSchema.IBigint
+  | IProtobufSchema.INumber
+  | IProtobufSchema.IString
+  | IProtobufSchema.IArray
+  | IProtobufSchema.IObject
+  | IProtobufSchema.IMap;
+export namespace IProtobufSchema {
+  export interface IByte {
+    type: "bytes";
+  }
+  export interface IBoolean {
+    type: "bool";
+  }
+  export interface IBigint {
+    type: "bigint";
+    name: "int64" | "uint64";
+  }
+  export interface INumber {
+    type: "number";
+    name: "int32" | "int64" | "uint32" | "uint64" | "float" | "double";
+  }
+  export interface IString {
+    type: "string";
+  }
+  export interface IArray {
+    type: "array";
+    array: MetadataArrayType;
+    value: Exclude<IProtobufSchema, IArray | IMap>;
+  }
+  export interface IObject {
+    type: "object";
+    object: MetadataObjectType;
+  }
+  export interface IMap {
+    type: "map";
+    map: MetadataMap | MetadataObjectType;
+    key:
+      | IProtobufSchema.IBoolean
+      | IProtobufSchema.INumber
+      | IProtobufSchema.IString;
+    value: Exclude<IProtobufSchema, IArray | IMap>;
+  }
+}

package/src/tags/Example.ts

@@ -1,17 +1,24 @@
-import { TagBase } from "./TagBase";
-
-export type Example<
-  Value extends boolean | bigint | number | string | Array<unknown> | null,
-> = TagBase<{
-  target: "boolean" | "bigint" | "number" | "string" | "array";
-  kind: "example";
-  value: Value;
-  exclusive: true;
-  schema: Value extends bigint
-    ? { example: Numeric<Value> }
-    : { example: Value };
-}>;
-
-type Numeric<T extends bigint> = `${T}` extends `${infer N extends number}`
-  ? N
-  : never;
+import { TagBase } from "./TagBase";
+
+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;
+  schema: Value extends bigint
+    ? { example: Numeric<Value> }
+    : { example: Value };
+}>;
+
+type Numeric<T extends bigint> = `${T}` extends `${infer N extends number}`
+  ? N
+  : never;

package/src/tags/Examples.ts

@@ -1,16 +1,16 @@
-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";
-  kind: "examples";
-  value: Dict;
-  exclusive: true;
-  schema: {
-    examples: Dict;
-  };
-}>;
+import { TagBase } from "./TagBase";
+
+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;
+  schema: {
+    examples: Dict;
+  };
+}>;

package/src/tags/JsonSchemaPlugin.ts

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

package/src/tags/Sequence.ts

@@ -0,0 +1,10 @@
+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/src/tags/TagBase.ts

@@ -1,76 +1,82 @@
-export type TagBase<
-  Props extends TagBase.IProps<any, any, any, any, any, any>,
-> = {
-  /**
-   * This is a dummy property for compilation.
-   *
-   * It does not mean anything in runtime.
-   */
-  "typia.tag"?: Props;
-};
-export namespace TagBase {
-  export interface IProps<
-    Target extends "boolean" | "bigint" | "number" | "string" | "array",
-    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,
-  > {
-    /**
-     * Target type.
-     *
-     * If user tries to adapt this tag to a different type, it would be a compile
-     * error.
-     *
-     * For example, you've configured target type as `string`, but user adapted it
-     * onto a `number` type (`number & YourCustomTag<Value>`), then it would be
-     * blocked by TypeScript compiler.
-     */
-    target: Target;
-
-    /**
-     * What kind of tag is this?
-     */
-    kind: Kind;
-
-    /**
-     * Value to be configured by user.
-     */
-    value: Value;
-
-    /**
-     * Validation script.
-     *
-     * This script would be inserted into the generated validation function.
-     * In here script, target variable name must be `$input`. The variable name
-     * `$input` would be transformed to the suitable when compilation.
-     *
-     * Also, If you've take a mistake on this script, compile error would be
-     * occured. So, define it with confidence. Compiler will block all your
-     * mistakes.
-     */
-    validate?: Validate;
-
-    /**
-     * Exclusive option.
-     *
-     * If this property configured as `true`, same {@link kind} tag cannot be
-     * duplicated in the target type. Otherwise, if you've configured this
-     * property as string array, all of the {@link kind} value assigned
-     * tags cannot be compatible in the target type.
-     *
-     * @default false
-     */
-    exclusive?: Exclusive | string[];
-
-    /**
-     * Additional schema info assigned to the {@link IJsonSchema} object.
-     */
-    schema?: Schema;
-  }
-}
+export type TagBase<
+  Props extends TagBase.IProps<any, any, any, any, any, any>,
+> = {
+  /**
+   * This is a dummy property for compilation.
+   *
+   * It does not mean anything in runtime.
+   */
+  "typia.tag"?: Props;
+};
+export namespace TagBase {
+  export 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,
+  > {
+    /**
+     * Target type.
+     *
+     * If user tries to adapt this tag to a different type, it would be a compile
+     * error.
+     *
+     * For example, you've configured target type as `string`, but user adapted it
+     * onto a `number` type (`number & YourCustomTag<Value>`), then it would be
+     * blocked by TypeScript compiler.
+     */
+    target: Target;
+
+    /**
+     * What kind of tag is this?
+     */
+    kind: Kind;
+
+    /**
+     * Value to be configured by user.
+     */
+    value: Value;
+
+    /**
+     * Validation script.
+     *
+     * This script would be inserted into the generated validation function.
+     * In here script, target variable name must be `$input`. The variable name
+     * `$input` would be transformed to the suitable when compilation.
+     *
+     * Also, If you've take a mistake on this script, compile error would be
+     * occured. So, define it with confidence. Compiler will block all your
+     * mistakes.
+     */
+    validate?: Validate;
+
+    /**
+     * Exclusive option.
+     *
+     * If this property configured as `true`, same {@link kind} tag cannot be
+     * duplicated in the target type. Otherwise, if you've configured this
+     * property as string array, all of the {@link kind} value assigned
+     * tags cannot be compatible in the target type.
+     *
+     * @default false
+     */
+    exclusive?: Exclusive | string[];
+
+    /**
+     * Additional schema info assigned to the {@link IJsonSchema} object.
+     */
+    schema?: Schema;
+  }
+}

package/src/tags/index.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/src/utils/{NameEncoder.ts → ProtobufNameEncoder.ts}

@@ -1,4 +1,4 @@
-export namespace NameEncoder {
+export namespace ProtobufNameEncoder {
   export const encode = (str: string): string => {
     for (const [before, after] of REPLACERS)
       str = str.split(before).join(after);

package/lib/schemas/metadata/IMetadataEntry.d.ts

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

package/lib/schemas/metadata/IMetadataEntry.js.map

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

package/lib/utils/NameEncoder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NameEncoder.js","sourceRoot":"","sources":["../../src/utils/NameEncoder.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAiB,WAAW,CAY3B;AAZD,WAAiB,WAAW;IACb,kBAAM,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,kBAAM,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,WAAW,2BAAX,WAAW,QAY3B;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"}