typia 7.0.0-dev.20240924 → 7.0.0-dev.20240929

package/src/programmers/json/JsonStringifyProgrammer.ts

@@ -47,9 +47,11 @@ export namespace JsonStringifyProgrammer {
     const config: FeatureProgrammer.IConfig = configure(props);
     if (props.validated === false)
       config.addition = (collection) =>
-        IsProgrammer.write_function_statements(props.context)(props.importer)(
+        IsProgrammer.write_function_statements({
+          context: props.context,
+          importer: props.importer,
           collection,
-        );
+        });
     const composed: FeatureProgrammer.IComposed = FeatureProgrammer.compose({
       ...props,
       config,
@@ -231,7 +233,11 @@ export namespace JsonStringifyProgrammer {
           props.metadata.escaped.original.size() === 1 &&
           props.metadata.escaped.original.natives[0] === "Date"
             ? () => check_native("Date")(props.input)
-            : () => IsProgrammer.decode_to_json(false)(props.input),
+            : () =>
+                IsProgrammer.decode_to_json({
+                  checkNull: false,
+                  input: props.input,
+                }),
         value: () =>
           decode_to_json({
             ...props,
@@ -255,11 +261,10 @@ export namespace JsonStringifyProgrammer {
           unions.push({
             type: "template literal",
             is: () =>
-              IsProgrammer.decode(props.context)(props.importer)(
-                props.input,
-                partial,
-                props.explore,
-              ),
+              IsProgrammer.decode({
+                ...props,
+                metadata: partial,
+              }),
             value: () =>
               decode_atomic({
                 ...props,
@@ -281,9 +286,9 @@ export namespace JsonStringifyProgrammer {
         unions.push({
           type: "atomic",
           is: () =>
-            IsProgrammer.decode(props.context)(props.importer)(
-              props.input,
-              (() => {
+            IsProgrammer.decode({
+              ...props,
+              metadata: (() => {
                 const partial = Metadata.initialize();
                 partial.atomics.push(
                   MetadataAtomic.create({
@@ -293,8 +298,7 @@ export namespace JsonStringifyProgrammer {
                 );
                 return partial;
               })(),
-              props.explore,
-            ),
+            }),
           value: () =>
             decode_atomic({
               ...props,
@@ -305,9 +309,9 @@ export namespace JsonStringifyProgrammer {
         unions.push({
           type: "const string",
           is: () =>
-            IsProgrammer.decode(props.context)(props.importer)(
-              props.input,
-              (() => {
+            IsProgrammer.decode({
+              ...props,
+              metadata: (() => {
                 const partial = Metadata.initialize();
                 partial.atomics.push(
                   MetadataAtomic.create({
@@ -317,8 +321,7 @@ export namespace JsonStringifyProgrammer {
                 );
                 return partial;
               })(),
-              props.explore,
-            ),
+            }),
           value: () =>
             decode_constant_string({
               ...props,
@@ -337,15 +340,14 @@ export namespace JsonStringifyProgrammer {
         unions.push({
           type: "atomic",
           is: () =>
-            IsProgrammer.decode(props.context)(props.importer)(
-              props.input,
-              (() => {
+            IsProgrammer.decode({
+              ...props,
+              metadata: (() => {
                 const partial = Metadata.initialize();
                 partial.atomics.push(a);
                 return partial;
               })(),
-              props.explore,
-            ),
+            }),
           value: () =>
             decode_atomic({
               ...props,
@@ -358,15 +360,14 @@ export namespace JsonStringifyProgrammer {
       unions.push({
         type: "tuple",
         is: () =>
-          IsProgrammer.decode(props.context)(props.importer)(
-            props.input,
-            (() => {
+          IsProgrammer.decode({
+            ...props,
+            metadata: (() => {
               const partial = Metadata.initialize();
               partial.tuples.push(tuple);
               return partial;
             })(),
-            props.explore,
-          ),
+          }),
         value: () =>
           decode_tuple({
             ...props,
@@ -755,7 +756,14 @@ export namespace JsonStringifyProgrammer {
       elements: props.arrays,
       factory: (next) =>
         UnionExplorer.array({
-          checker: IsProgrammer.decode(props.context)(props.importer),
+          checker: (input, metadata, explore) =>
+            IsProgrammer.decode({
+              context: props.context,
+              importer: props.importer,
+              metadata,
+              input,
+              explore,
+            }),
           decoder: (input, array, explore) =>
             decode_array({
               config: props.config,
@@ -812,7 +820,7 @@ export namespace JsonStringifyProgrammer {
         [],
       );
 
-    const explore: FeatureProgrammer.IExplore = {
+    const arrayExplore: FeatureProgrammer.IExplore = {
       ...props.explore,
       source: "function",
       from: "array",
@@ -828,7 +836,7 @@ export namespace JsonStringifyProgrammer {
                 TypeFactory.keyword("any"),
               )(ts.factory.createIdentifier("input")),
               explore: {
-                ...explore,
+                ...arrayExplore,
                 postfix: "",
               },
               input: ts.factory.createIdentifier("input"),
@@ -836,7 +844,7 @@ export namespace JsonStringifyProgrammer {
         ),
       ),
       undefined,
-      FeatureProgrammer.argumentsArray(props.config)(explore)(props.input),
+      FeatureProgrammer.argumentsArray(props.config)(arrayExplore)(props.input),
     );
   };
 
@@ -949,7 +957,14 @@ export namespace JsonStringifyProgrammer {
           explore,
         }),
       objector: {
-        checker: () => IsProgrammer.decode(props.context)(props.importer),
+        checker: () => (input, metadata, explore) =>
+          IsProgrammer.decode({
+            context: props.context,
+            importer: props.importer,
+            metadata,
+            input,
+            explore,
+          }),
         decoder: () => (input, object, explore) =>
           decode_object({
             importer: props.importer,
@@ -962,8 +977,14 @@ export namespace JsonStringifyProgrammer {
             ...next,
             importer: props.importer,
           }),
-        unionizer: decode_union_object(
-          IsProgrammer.decode_object(props.context)(props.importer),
+        unionizer: decode_union_object((input, object, explore) =>
+          IsProgrammer.decode_object({
+            context: props.context,
+            importer: props.importer,
+            input,
+            object,
+            explore,
+          }),
         )((input, object, explore) =>
           decode_object({
             importer: props.importer,

package/src/programmers/llm/LlmApplicationProgrammer.ts

@@ -104,38 +104,57 @@ export namespace LlmApplicationProgrammer {
     function: MetadataFunction;
     description: string | null;
     jsDocTags: IJsDocTagInfo[];
-  }): ILlmFunction => ({
-    name: props.name,
-    parameters: props.function.parameters.map((p) => {
-      const jsDocTagDescription = writeDescriptionFromJsDocTag({
-        jsDocTags: p.jsDocTags,
-        tag: "param",
-        parameter: p.name,
-      });
-      return writeSchema({
-        metadata: p.type,
-        description: jsDocTagDescription ?? p.description,
-        jsDocTags: jsDocTagDescription ? [] : p.jsDocTags,
-      });
-    }),
-    output:
-      props.function.output.size() || props.function.output.nullable
-        ? writeSchema({
-            metadata: props.function.output,
-            description:
-              writeDescriptionFromJsDocTag({
-                jsDocTags: props.jsDocTags,
-                tag: "return",
-              }) ??
-              writeDescriptionFromJsDocTag({
-                jsDocTags: props.jsDocTags,
-                tag: "returns",
-              }),
-            jsDocTags: [],
-          })
-        : undefined,
-    description: props.description ?? undefined,
-  });
+  }): ILlmFunction => {
+    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,
+      parameters: props.function.parameters.map((p) => {
+        const jsDocTagDescription: string | null = writeDescriptionFromJsDocTag(
+          {
+            jsDocTags: p.jsDocTags,
+            tag: "param",
+            parameter: p.name,
+          },
+        );
+        return writeSchema({
+          metadata: p.type,
+          description: jsDocTagDescription ?? p.description,
+          jsDocTags: jsDocTagDescription ? [] : p.jsDocTags,
+        });
+      }),
+      output:
+        props.function.output.size() || props.function.output.nullable
+          ? writeSchema({
+              metadata: props.function.output,
+              description:
+                writeDescriptionFromJsDocTag({
+                  jsDocTags: props.jsDocTags,
+                  tag: "return",
+                }) ??
+                writeDescriptionFromJsDocTag({
+                  jsDocTags: props.jsDocTags,
+                  tag: "returns",
+                }),
+              jsDocTags: [],
+            })
+          : undefined,
+      description: props.description ?? undefined,
+      deprecated: deprecated || undefined,
+      tags: tags.length ? tags : undefined,
+    };
+  };
 
   const writeSchema = (props: {
     metadata: Metadata;

package/src/programmers/misc/MiscCloneProgrammer.ts

@@ -37,9 +37,11 @@ export namespace MiscCloneProgrammer {
     const config: FeatureProgrammer.IConfig = configure(props);
     if (props.validated === false)
       config.addition = (collection) =>
-        IsProgrammer.write_function_statements(props.context)(props.importer)(
+        IsProgrammer.write_function_statements({
+          context: props.context,
+          importer: props.importer,
           collection,
-        );
+        });
     const composed: FeatureProgrammer.IComposed = FeatureProgrammer.compose({
       ...props,
       config,
@@ -201,15 +203,14 @@ export namespace MiscCloneProgrammer {
       unions.push({
         type: "tuple",
         is: () =>
-          IsProgrammer.decode(props.context)(props.importer)(
-            props.input,
-            (() => {
+          IsProgrammer.decode({
+            ...props,
+            metadata: (() => {
               const partial = Metadata.initialize();
               partial.tuples.push(tuple);
               return partial;
             })(),
-            props.explore,
-          ),
+          }),
         value: () =>
           decode_tuple({
             ...props,
@@ -557,7 +558,14 @@ export namespace MiscCloneProgrammer {
   }): ts.Expression =>
     ts.factory.createCallExpression(
       UnionExplorer.set({
-        checker: IsProgrammer.decode(props.context)(props.importer),
+        checker: (input, metadata, explore) =>
+          IsProgrammer.decode({
+            context: props.context,
+            importer: props.importer,
+            input,
+            metadata,
+            explore,
+          }),
         decoder: (input, array, explore) =>
           ts.factory.createNewExpression(
             ts.factory.createIdentifier("Set"),
@@ -599,19 +607,29 @@ export namespace MiscCloneProgrammer {
   }): ts.Expression =>
     ts.factory.createCallExpression(
       UnionExplorer.map({
-        checker: (top, entry, explore) => {
-          const func = IsProgrammer.decode(props.context)(props.importer);
-          return ts.factory.createLogicalAnd(
-            func(ts.factory.createElementAccessExpression(top, 0), entry[0], {
-              ...explore,
-              postfix: `${explore.postfix}[0]`,
+        checker: (top, entry, explore) =>
+          ts.factory.createLogicalAnd(
+            IsProgrammer.decode({
+              context: props.context,
+              importer: props.importer,
+              input: ts.factory.createElementAccessExpression(top, 0),
+              metadata: entry[0],
+              explore: {
+                ...explore,
+                postfix: `${explore.postfix}[0]`,
+              },
             }),
-            func(ts.factory.createElementAccessExpression(top, 1), entry[1], {
-              ...explore,
-              postfix: `${explore.postfix}[1]`,
+            IsProgrammer.decode({
+              context: props.context,
+              importer: props.importer,
+              input: ts.factory.createElementAccessExpression(top, 1),
+              metadata: entry[1],
+              explore: {
+                ...explore,
+                postfix: `${explore.postfix}[1]`,
+              },
             }),
-          );
-        },
+          ),
         decoder: (input, array, explore) =>
           ts.factory.createNewExpression(
             ts.factory.createIdentifier("Map"),
@@ -678,7 +696,14 @@ export namespace MiscCloneProgrammer {
       elements: props.arrays,
       factory: (next) =>
         UnionExplorer.array({
-          checker: IsProgrammer.decode(props.context)(props.importer),
+          checker: (input, metadata, explore) =>
+            IsProgrammer.decode({
+              context: props.context,
+              importer: props.importer,
+              input,
+              metadata,
+              explore,
+            }),
           decoder: (input, array, explore) =>
             decode_array({
               config: props.config,
@@ -735,7 +760,7 @@ export namespace MiscCloneProgrammer {
         [],
       );
 
-    const explore: FeatureProgrammer.IExplore = {
+    const arrayExplore: FeatureProgrammer.IExplore = {
       ...props.explore,
       source: "function",
       from: "array",
@@ -751,7 +776,7 @@ export namespace MiscCloneProgrammer {
                 TypeFactory.keyword("any"),
               )(ts.factory.createIdentifier("input")),
               explore: {
-                ...explore,
+                ...arrayExplore,
                 postfix: "",
               },
               input: ts.factory.createIdentifier("input"),
@@ -759,7 +784,7 @@ export namespace MiscCloneProgrammer {
         ),
       ),
       undefined,
-      FeatureProgrammer.argumentsArray(props.config)(explore)(props.input),
+      FeatureProgrammer.argumentsArray(props.config)(arrayExplore)(props.input),
     );
   };
 
@@ -807,7 +832,14 @@ export namespace MiscCloneProgrammer {
           explore,
         }),
       objector: {
-        checker: () => IsProgrammer.decode(props.context)(props.importer),
+        checker: () => (input, metadata, explore) =>
+          IsProgrammer.decode({
+            context: props.context,
+            importer: props.importer,
+            input,
+            metadata,
+            explore,
+          }),
         decoder: () => (input, object, explore) =>
           decode_object({
             importer: props.importer,
@@ -816,8 +848,14 @@ export namespace MiscCloneProgrammer {
             explore,
           }),
         joiner: CloneJoiner.object,
-        unionizer: decode_union_object(
-          IsProgrammer.decode_object(props.context)(props.importer),
+        unionizer: decode_union_object((input, object, explore) =>
+          IsProgrammer.decode_object({
+            context: props.context,
+            importer: props.importer,
+            input,
+            object,
+            explore,
+          }),
         )((input, object, explore) =>
           decode_object({
             importer: props.importer,

package/src/programmers/misc/MiscPruneProgrammer.ts

@@ -37,9 +37,11 @@ export namespace MiscPruneProgrammer {
     const config = configure(props);
     if (props.validated === false)
       config.addition = (collection) =>
-        IsProgrammer.write_function_statements(props.context)(props.importer)(
+        IsProgrammer.write_function_statements({
+          context: props.context,
+          importer: props.importer,
           collection,
-        );
+        });
     const composed: FeatureProgrammer.IComposed = FeatureProgrammer.compose({
       ...props,
       config,
@@ -179,15 +181,14 @@ export namespace MiscPruneProgrammer {
       unions.push({
         type: "tuple",
         is: () =>
-          IsProgrammer.decode(props.context)(props.importer)(
-            props.input,
-            (() => {
+          IsProgrammer.decode({
+            ...props,
+            metadata: (() => {
               const partial = Metadata.initialize();
               partial.tuples.push(tuple);
               return partial;
             })(),
-            props.explore,
-          ),
+          }),
         value: () =>
           decode_tuple({
             ...props,
@@ -433,7 +434,14 @@ export namespace MiscPruneProgrammer {
       elements: props.arrays,
       factory: (next) =>
         UnionExplorer.array({
-          checker: IsProgrammer.decode(props.context)(props.importer),
+          checker: (input, metadata, explore) =>
+            IsProgrammer.decode({
+              context: props.context,
+              importer: props.importer,
+              metadata,
+              input,
+              explore,
+            }),
           decoder: (input, array, explore) =>
             decode_array({
               config: props.config,
@@ -490,7 +498,7 @@ export namespace MiscPruneProgrammer {
         [],
       );
 
-    const explore: FeatureProgrammer.IExplore = {
+    const arrayExplore: FeatureProgrammer.IExplore = {
       ...props.explore,
       source: "function",
       from: "array",
@@ -506,7 +514,7 @@ export namespace MiscPruneProgrammer {
                 TypeFactory.keyword("any"),
               )(ts.factory.createIdentifier("input")),
               explore: {
-                ...explore,
+                ...arrayExplore,
                 postfix: "",
               },
               input: ts.factory.createIdentifier("input"),
@@ -562,7 +570,14 @@ export namespace MiscPruneProgrammer {
           explore,
         }),
       objector: {
-        checker: () => IsProgrammer.decode(props.context)(props.importer),
+        checker: () => (input, metadata, explore) =>
+          IsProgrammer.decode({
+            context: props.context,
+            importer: props.importer,
+            input,
+            metadata,
+            explore,
+          }),
         decoder: () => (input, object, explore) =>
           decode_object({
             importer: props.importer,
@@ -571,8 +586,14 @@ export namespace MiscPruneProgrammer {
             explore,
           }),
         joiner: PruneJoiner.object,
-        unionizer: decode_union_object(
-          IsProgrammer.decode_object(props.context)(props.importer),
+        unionizer: decode_union_object((input, object, explore) =>
+          IsProgrammer.decode_object({
+            context: props.context,
+            importer: props.importer,
+            input,
+            object,
+            explore,
+          }),
         )((input, object, explore) =>
           decode_object({
             importer: props.importer,