@typia/core 12.0.0-dev.20260225

package/src/programmers/iterate/metadata_to_pattern.ts

@@ -0,0 +1,38 @@
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+import { PatternUtil } from "../../utils/PatternUtil";
+import { template_to_pattern } from "./template_to_pattern";
+
+/** @internal */
+export const metadata_to_pattern = (props: {
+  top: boolean;
+  metadata: MetadataSchema;
+}): string => {
+  if (props.metadata.atomics.find((a) => a.type === "string") !== undefined)
+    return "(.*)";
+
+  const values: string[] = props.metadata.constants
+    .map((c) => {
+      if (c.type !== "string") return c.values.map((v) => v.toString());
+      return (c.values.map((v) => v.value) as string[]).map((str) =>
+        PatternUtil.escape(str),
+      );
+    })
+    .flat();
+  for (const a of props.metadata.atomics)
+    if (a.type === "number" || a.type === "bigint")
+      values.push(PatternUtil.NUMBER);
+    else if (a.type === "boolean") values.push(PatternUtil.BOOLEAN);
+  for (const { row } of props.metadata.templates)
+    values.push(
+      "(" +
+        template_to_pattern({
+          top: false,
+          template: row,
+        }) +
+        ")",
+    );
+
+  const pattern: string =
+    values.length === 1 ? values[0]! : "(" + values.join("|") + ")";
+  return props.top ? PatternUtil.fix(pattern) : pattern;
+};

package/src/programmers/iterate/postfix_of_tuple.ts

@@ -0,0 +1,3 @@
+/** @internal */
+export const postfix_of_tuple = (str: string): string =>
+  str.endsWith('"') ? str.slice(0, -1) : `${str} + "`;

package/src/programmers/iterate/prune_object_properties.ts

@@ -0,0 +1,68 @@
+import ts from "typescript";
+
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/** @internal */
+export const prune_object_properties = (object: MetadataObjectType) => {
+  const input: ts.Expression = ts.factory.createIdentifier("input");
+  const key: ts.Expression = ts.factory.createIdentifier("key");
+
+  const condition: ts.Expression[] = object.properties.map((prop) => {
+    const name: string | null = prop.key.getSoleLiteral();
+    if (name !== null)
+      return ts.factory.createStrictEquality(
+        ts.factory.createStringLiteral(name),
+        ts.factory.createIdentifier("key"),
+      );
+    return ts.factory.createCallExpression(
+      ts.factory.createIdentifier(
+        `RegExp(/${metadata_to_pattern({
+          top: true,
+          metadata: prop.key,
+        })}/).test`,
+      ),
+      undefined,
+      [key],
+    );
+  });
+
+  const statements: ts.Statement[] = [];
+  if (condition.length)
+    statements.push(
+      ts.factory.createIfStatement(
+        condition.reduce((a, b) => ts.factory.createLogicalOr(a, b)),
+        ts.factory.createContinueStatement(),
+      ),
+    );
+  statements.push(
+    ts.factory.createExpressionStatement(
+      ts.factory.createDeleteExpression(
+        ts.factory.createElementAccessExpression(input, key),
+      ),
+    ),
+  );
+
+  return ts.factory.createForOfStatement(
+    undefined,
+    ts.factory.createVariableDeclarationList(
+      [
+        ts.factory.createVariableDeclaration(
+          ts.factory.createIdentifier("key"),
+          undefined,
+          undefined,
+          undefined,
+        ),
+      ],
+      ts.NodeFlags.Const,
+    ),
+    ts.factory.createCallExpression(
+      ts.factory.createIdentifier("Object.keys"),
+      undefined,
+      [input],
+    ),
+    statements.length === 1
+      ? statements[0]!
+      : ts.factory.createBlock(statements, true),
+  );
+};

package/src/programmers/iterate/stringify_dynamic_properties.ts

@@ -0,0 +1,157 @@
+import ts from "typescript";
+
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+import { TemplateFactory } from "../../factories/TemplateFactory";
+import { IExpressionEntry } from "../helpers/IExpressionEntry";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/** @internal */
+export const stringify_dynamic_properties = (
+  dynamic: IExpressionEntry<ts.Expression>[],
+  regular: string[],
+): ts.Expression => {
+  // BASIC STATMEMENT, CHECK UNDEFINED
+  const statements: ts.Statement[] = [
+    ts.factory.createIfStatement(
+      ts.factory.createStrictEquality(
+        ts.factory.createIdentifier("undefined"),
+        ts.factory.createIdentifier("value"),
+      ),
+      ts.factory.createReturnStatement(ts.factory.createStringLiteral("")),
+    ),
+  ];
+
+  // PREPARE RETURN FUNCTION
+  const output = () => {
+    const mapped = ts.factory.createCallExpression(
+      IdentifierFactory.access(
+        ts.factory.createCallExpression(
+          ts.factory.createIdentifier("Object.entries"),
+          undefined,
+          [ts.factory.createIdentifier("input")],
+        ),
+        "map",
+      ),
+      undefined,
+      [
+        ts.factory.createArrowFunction(
+          undefined,
+          undefined,
+          [
+            IdentifierFactory.parameter(
+              ts.factory.createArrayBindingPattern([
+                ts.factory.createBindingElement(undefined, undefined, "key"),
+                ts.factory.createBindingElement(undefined, undefined, "value"),
+              ]),
+              ts.factory.createTypeReferenceNode("[string, any]"),
+            ),
+          ],
+          undefined,
+          undefined,
+          ts.factory.createBlock(statements),
+        ),
+      ],
+    );
+    const filtered = ts.factory.createCallExpression(
+      IdentifierFactory.access(mapped, "filter"),
+      undefined,
+      [
+        ts.factory.createArrowFunction(
+          undefined,
+          undefined,
+          [IdentifierFactory.parameter("str")],
+          undefined,
+          undefined,
+          ts.factory.createStrictInequality(
+            ts.factory.createStringLiteral(""),
+            ts.factory.createIdentifier("str"),
+          ),
+        ),
+      ],
+    );
+    return ts.factory.createCallExpression(
+      IdentifierFactory.access(filtered, "join"),
+      undefined,
+      [ts.factory.createStringLiteral(",")],
+    );
+  };
+
+  // WHEN REGULAR PROPERTY EXISTS
+  if (regular.length)
+    statements.push(
+      ts.factory.createIfStatement(
+        ts.factory.createCallExpression(
+          IdentifierFactory.access(
+            ts.factory.createArrayLiteralExpression(
+              regular.map((key) => ts.factory.createStringLiteral(key)),
+            ),
+            "some",
+          ),
+          undefined,
+          [
+            ts.factory.createArrowFunction(
+              undefined,
+              undefined,
+              [IdentifierFactory.parameter("regular")],
+              undefined,
+              undefined,
+              ts.factory.createStrictEquality(
+                ts.factory.createIdentifier("regular"),
+                ts.factory.createIdentifier("key"),
+              ),
+            ),
+          ],
+        ),
+        ts.factory.createReturnStatement(ts.factory.createStringLiteral("")),
+      ),
+    );
+
+  // ONLY STRING TYPED KEY EXISTS
+  const simple: boolean =
+    dynamic.length === 1 &&
+    dynamic[0]!.key.size() === 1 &&
+    dynamic[0]!.key.atomics[0]?.type === "string";
+  if (simple === true) {
+    statements.push(stringify(dynamic[0]!));
+    return output();
+  }
+
+  // COMPOSITE TEMPLATE LITERAL TYPES
+  for (const entry of dynamic) {
+    const condition: ts.IfStatement = ts.factory.createIfStatement(
+      ts.factory.createCallExpression(
+        ts.factory.createIdentifier(
+          `RegExp(/${metadata_to_pattern({
+            top: true,
+            metadata: entry.key,
+          })}/).test`,
+        ),
+        undefined,
+        [ts.factory.createIdentifier("key")],
+      ),
+      stringify(entry),
+    );
+    statements.push(condition);
+  }
+  statements.push(
+    ts.factory.createReturnStatement(ts.factory.createStringLiteral("")),
+  );
+
+  return output();
+};
+
+/** @internal */
+const stringify = (
+  entry: IExpressionEntry<ts.Expression>,
+): ts.ReturnStatement =>
+  ts.factory.createReturnStatement(
+    TemplateFactory.generate([
+      ts.factory.createCallExpression(
+        ts.factory.createIdentifier("JSON.stringify"),
+        [],
+        [ts.factory.createIdentifier("key")],
+      ),
+      ts.factory.createStringLiteral(":"),
+      entry.expression,
+    ]),
+  );

package/src/programmers/iterate/stringify_native.ts

@@ -0,0 +1,5 @@
+import ts from "typescript";
+
+/** @internal */
+export const stringify_native = (): ts.Expression =>
+  ts.factory.createStringLiteral("{}");

package/src/programmers/iterate/stringify_regular_properties.ts

@@ -0,0 +1,75 @@
+import ts from "typescript";
+
+import { TemplateFactory } from "../../factories/TemplateFactory";
+import { ValueFactory } from "../../factories/ValueFactory";
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+import { IExpressionEntry } from "../helpers/IExpressionEntry";
+
+/** @internal */
+export const stringify_regular_properties = (props: {
+  regular: IExpressionEntry<ts.Expression>[];
+  dynamic: IExpressionEntry<ts.Expression>[];
+}): ts.Expression[] => {
+  const output: ts.Expression[] = [];
+
+  props.regular.sort((x, y) => sequence(x.meta) - sequence(y.meta));
+  props.regular.forEach((entry, index) => {
+    // BASE ELEMENTS
+    const key: string = entry.key.getSoleLiteral()!;
+    const base: ts.Expression[] = [
+      ts.factory.createStringLiteral(`${JSON.stringify(key)}:`),
+      entry.expression,
+    ];
+    if (index !== props.regular.length - 1 || props.dynamic.length !== 0)
+      base.push(ts.factory.createStringLiteral(`,`));
+
+    const empty: boolean =
+      (entry.meta.isRequired() === false &&
+        entry.meta.nullable === false &&
+        entry.meta.size() === 0) ||
+      (!!entry.meta.functions.length &&
+        entry.meta.nullable === false &&
+        entry.meta.size() === 1);
+
+    if (empty === true) return;
+    else if (
+      entry.meta.isRequired() === false ||
+      entry.meta.functions.length ||
+      entry.meta.any === true
+    )
+      output.push(
+        ts.factory.createConditionalExpression(
+          (() => {
+            const conditions: ts.BinaryExpression[] = [];
+            if (entry.meta.isRequired() === false || entry.meta.any)
+              conditions.push(
+                ts.factory.createStrictEquality(
+                  ts.factory.createIdentifier("undefined"),
+                  entry.input,
+                ),
+              );
+            if (entry.meta.functions.length || entry.meta.any)
+              conditions.push(
+                ts.factory.createStrictEquality(
+                  ts.factory.createStringLiteral("function"),
+                  ValueFactory.TYPEOF(entry.input),
+                ),
+              );
+            return conditions.length === 1
+              ? conditions[0]!
+              : conditions.reduce((x, y) => ts.factory.createLogicalOr(x, y));
+          })(),
+          undefined,
+          ts.factory.createStringLiteral(""),
+          undefined,
+          TemplateFactory.generate(base),
+        ),
+      );
+    else output.push(...base);
+  });
+  return output;
+};
+
+/** @internal */
+const sequence = (meta: MetadataSchema): number =>
+  meta.any || !meta.isRequired() || meta.functions.length ? 0 : 1;

package/src/programmers/iterate/template_to_pattern.ts

@@ -0,0 +1,19 @@
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+import { PatternUtil } from "../../utils/PatternUtil";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/** @internal */
+export const template_to_pattern = (props: {
+  top: boolean;
+  template: MetadataSchema[];
+}) => {
+  const pattern: string = props.template
+    .map((meta) =>
+      metadata_to_pattern({
+        top: false,
+        metadata: meta,
+      }),
+    )
+    .join("");
+  return props.top ? PatternUtil.fix(pattern) : pattern;
+};

package/src/programmers/iterate/wrap_metadata_rest_tuple.ts

@@ -0,0 +1,21 @@
+import { MetadataArray } from "../../schemas/metadata/MetadataArray";
+import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+
+/** @internal */
+export const wrap_metadata_rest_tuple = (rest: MetadataSchema) => {
+  const wrapper: MetadataSchema = MetadataSchema.initialize();
+  wrapper.arrays.push(
+    MetadataArray.create({
+      type: MetadataArrayType.create({
+        name: `...${rest.getName()}`,
+        value: rest,
+        nullables: [],
+        recursive: false,
+        index: null,
+      }),
+      tags: [],
+    }),
+  );
+  return wrapper;
+};

package/src/programmers/json/JsonApplicationProgrammer.ts

@@ -0,0 +1,270 @@
+import { IJsDocTagInfo, IJsonSchemaApplication } from "@typia/interface";
+
+import { MetadataFactory } from "../../factories/MetadataFactory";
+import { MetadataFunction } from "../../schemas/metadata/MetadataFunction";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+import { MetadataSchema } from "../../schemas/metadata/MetadataSchema";
+import { JsonSchemasProgrammer } from "./JsonSchemasProgrammer";
+
+export namespace JsonApplicationProgrammer {
+  export const validate = (
+    metadata: MetadataSchema,
+    explore: MetadataFactory.IExplore,
+  ): string[] => {
+    if (explore.top === false) return JsonSchemasProgrammer.validate(metadata);
+
+    const output: string[] = [];
+    const valid: boolean =
+      metadata.size() === 1 &&
+      metadata.objects.length === 1 &&
+      metadata.isRequired() === true &&
+      metadata.nullable === false;
+    if (valid === false)
+      output.push(
+        "JSON application's generic argument must be a class/interface type.",
+      );
+
+    const object: MetadataObjectType | undefined = metadata.objects[0]?.type;
+    if (object !== undefined) {
+      if (object.properties.some((p) => p.key.isSoleLiteral() === false))
+        output.push("JSON application does not allow dynamic keys.");
+      let least: boolean = false;
+      for (const p of object.properties) {
+        const value: MetadataSchema = p.value;
+        if (value.functions.length) {
+          least ||= true;
+          if (valid === false) {
+            if (value.functions.length !== 1 || value.size() !== 1)
+              output.push(
+                "JSON application's function type does not allow union type.",
+              );
+            if (value.isRequired() === false)
+              output.push("JSON application's function type must be required.");
+            if (value.nullable === true)
+              output.push(
+                "JSON application's function type must not be nullable.",
+              );
+          }
+        }
+      }
+      if (least === false)
+        output.push(
+          "JSON application's target type must have at least a function type.",
+        );
+    }
+    return output;
+  };
+
+  export const write = <Version extends "3.0" | "3.1">(props: {
+    version: Version;
+    metadata: MetadataSchema;
+    filter?: (prop: MetadataProperty) => boolean;
+  }): IJsonSchemaApplication<Version> => {
+    const object: MetadataObjectType = props.metadata.objects[0]!.type;
+    const definitions: MetadataSchema[] = [];
+    const setters: Array<
+      (schema: IJsonSchemaApplication.Schema<Version>) => void
+    > = [];
+    const collect = (
+      metadata: MetadataSchema,
+      setter: (schema: IJsonSchemaApplication.Schema<Version>) => void,
+    ): void => {
+      definitions.push(metadata);
+      setters.push(setter);
+    };
+
+    const functions: IJsonSchemaApplication.IFunction<
+      IJsonSchemaApplication.Schema<Version>
+    >[] = object.properties
+      .filter(
+        (p) =>
+          p.key.isSoleLiteral() &&
+          p.value.size() === 1 &&
+          p.value.nullable === false &&
+          p.value.isRequired() === true &&
+          MetadataSchema.unalias(p.value).functions.length === 1,
+      )
+      .filter(
+        (p) =>
+          p.jsDocTags.find(
+            (tag) =>
+              tag.name === "hidden" ||
+              tag.name === "ignore" ||
+              tag.name === "internal",
+          ) === undefined &&
+          (props.filter === undefined || props.filter(p) === true),
+      )
+      .map((r) =>
+        collectFunction({
+          version: props.version,
+          name: r.key.getSoleLiteral()!,
+          function: MetadataSchema.unalias(r.value).functions[0]!,
+          description: r.description,
+          jsDocTags: r.jsDocTags,
+          collect,
+        }),
+      );
+    const { components, schemas } = JsonSchemasProgrammer.write({
+      version: props.version,
+      metadatas: definitions,
+    });
+    schemas.forEach((s, i) =>
+      setters[i]?.(s as IJsonSchemaApplication.Schema<Version>),
+    );
+    return {
+      version: props.version,
+      components: components as any,
+      functions,
+    };
+  };
+
+  export const writeDescription = <Kind extends "summary" | "title">(props: {
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+    kind: Kind;
+  }): Kind extends "summary"
+    ? { summary?: string; description?: string }
+    : { title?: string; description?: string } => {
+    const title: string | undefined = (() => {
+      const [explicit] = getJsDocTexts({
+        jsDocTags: props.jsDocTags,
+        name: props.kind,
+      });
+      if (explicit?.length) return explicit;
+      else if (!props.description?.length) return undefined;
+
+      const index: number = props.description.indexOf("\n");
+      const top: string = (
+        index === -1 ? props.description : props.description.substring(0, index)
+      ).trim();
+      return top.endsWith(".") ? top.substring(0, top.length - 1) : undefined;
+    })();
+    return {
+      [props.kind]: title,
+      description: props.description?.length ? props.description : undefined,
+    } as any;
+  };
+
+  const collectFunction = <Version extends "3.0" | "3.1">(props: {
+    version: Version;
+    name: string;
+    function: MetadataFunction;
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+    collect: (
+      metadata: MetadataSchema,
+      setter: (schema: IJsonSchemaApplication.Schema<Version>) => void,
+    ) => void;
+  }): IJsonSchemaApplication.IFunction<
+    IJsonSchemaApplication.Schema<Version>
+  > => {
+    const deprecated: boolean = props.jsDocTags.some(
+      (tag) => tag.name === "deprecated",
+    );
+    const tags: string[] = props.jsDocTags
+      .map((tag) =>
+        tag.name === "tag"
+          ? (tag.text?.filter((elem) => elem.kind === "text") ?? [])
+          : [],
+      )
+      .flat()
+      .map((elem) => elem.text)
+      .map((str) => str.trim().split(" ")[0] ?? "")
+      .filter((str) => !!str.length);
+    return {
+      name: props.name,
+      async: props.function.async,
+      parameters: props.function.parameters.map((param) => {
+        const appParam: IJsonSchemaApplication.IParameter<
+          IJsonSchemaApplication.Schema<Version>
+        > = {
+          name: param.name,
+          ...writeDescription({
+            description:
+              param.description ??
+              param.jsDocTags.find((tag) => tag.name === "description")
+                ?.text?.[0]?.text ??
+              props.jsDocTags
+                .find(
+                  (tag) =>
+                    tag.name === "param" && tag.text?.[0]?.text === param.name,
+                )
+                ?.text?.map((e) => e.text)
+                .join("")
+                .substring(param.name.length) ??
+              null,
+            jsDocTags: props.jsDocTags,
+            kind: "title",
+          }),
+          required: param.type.isRequired(),
+          schema: null!,
+        };
+        props.collect(param.type, (schema) => (appParam.schema = schema));
+        return appParam;
+      }),
+      output: props.function.output.size()
+        ? (() => {
+            const appOutput: IJsonSchemaApplication.IOutput<
+              IJsonSchemaApplication.Schema<Version>
+            > = {
+              schema: null!,
+              required: props.function.output.isRequired(),
+              description:
+                writeDescriptionFromJsDocTag({
+                  jsDocTags: props.jsDocTags,
+                  name: "return",
+                }) ??
+                writeDescriptionFromJsDocTag({
+                  jsDocTags: props.jsDocTags,
+                  name: "returns",
+                }) ??
+                undefined,
+            };
+            props.collect(
+              props.function.output,
+              (schema) => (appOutput.schema = schema),
+            );
+            return appOutput;
+          })()
+        : undefined,
+      description: props.description ?? undefined,
+      deprecated: deprecated || undefined,
+      tags: tags.length ? tags : undefined,
+    };
+  };
+}
+
+const writeDescriptionFromJsDocTag = (props: {
+  jsDocTags: IJsDocTagInfo[];
+  name: string;
+  parameter?: string;
+}): string | null => {
+  const parametric: (elem: IJsDocTagInfo) => boolean = props.parameter
+    ? (tag) =>
+        tag.text!.find(
+          (elem) =>
+            elem.kind === "parameterName" && elem.text === props.parameter,
+        ) !== undefined
+    : () => true;
+  const tag: IJsDocTagInfo | undefined = props.jsDocTags.find(
+    (tag) => tag.name === props.name && tag.text && parametric(tag),
+  );
+  return tag && tag.text
+    ? (tag.text.find((elem) => elem.kind === "text")?.text ?? null)
+    : null;
+};
+
+const getJsDocTexts = (props: {
+  jsDocTags: IJsDocTagInfo[];
+  name: string;
+}): string[] =>
+  props.jsDocTags
+    .filter(
+      (tag) =>
+        tag.name === props.name &&
+        tag.text &&
+        tag.text.find((elem) => elem.kind === "text" && elem.text.length) !==
+          undefined,
+    )
+    .map((tag) => tag.text!.find((elem) => elem.kind === "text")!.text);