Block LLM function schema composition by @human tag.

Follows the samchon/openapi#106 concept.

package.json

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

packages/typescript-json/README.md

@@ -46,7 +46,7 @@ export namespace protobuf {
 export function random<T>(g?: Partial<IRandomGenerator>): T;
 ```
 
-Typia is a transformer library supporting below features:
+`typia` is a transformer library supporting below features:
 
   - Super-fast Runtime Validators
   - Enhanced JSON schema and serde functions
@@ -63,6 +63,31 @@ Typia is a transformer library supporting below features:
 
 
 
+## Transformation
+If you call `typia` function, it would be compiled like below.
+
+This is the key concept of `typia`, transforming TypeScript type to a runtime function. The `typia.is<T>()` function is transformed to a dedicated type checker by analyzing the target type `T` in the compilation level.
+
+This feature enables developers to ensure type safety in their applications, leveraging TypeScript's static typing while also providing runtime validation. Instead of defining additional schemas, you can simply utilize the pure TypeScript type itself.
+
+```typescript
+//----
+// examples/checkString.ts
+//----
+import typia, { tags } from "typia";
+export const checkString = typia.createIs<string>();
+
+//----
+// examples/checkUUID.js
+//----
+import typia from "typia";
+export const checkString = (() => {
+  return (input) => "string" === typeof input;
+})();
+```
+
+
+
 ## Sponsors
 Thanks for your support.
 

packages/typescript-json/package.json

@@ -1,6 +1,6 @@
 {
   "name": "typescript-json",
-  "version": "7.1.0-dev.20241209",
+  "version": "7.2.1-dev.20241212",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -37,7 +37,7 @@
   },
   "homepage": "https://typia.io",
   "dependencies": {
-    "typia": "7.1.0-dev.20241209"
+    "typia": "7.2.1-dev.20241212"
   },
   "peerDependencies": {
     "typescript": ">=4.8.0 <5.8.0",

src/programmers/json/JsonApplicationProgrammer.ts

@@ -5,6 +5,7 @@ import { IJsDocTagInfo } from "../../schemas/metadata/IJsDocTagInfo";
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataFunction } from "../../schemas/metadata/MetadataFunction";
 import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
 
 import { JsonSchemasProgrammer } from "./JsonSchemasProgrammer";
 
@@ -60,6 +61,7 @@ export namespace JsonApplicationProgrammer {
   export const write = <Version extends "3.0" | "3.1">(props: {
     version: Version;
     metadata: Metadata;
+    filter?: (prop: MetadataProperty) => boolean;
   }): __IJsonApplication<Version> => {
     const errors: string[] = validate(props.metadata, {
       top: true,
@@ -101,7 +103,8 @@ export namespace JsonApplicationProgrammer {
         (p) =>
           p.jsDocTags.find(
             (tag) => tag.name === "hidden" || tag.name === "internal",
-          ) === undefined,
+          ) === undefined &&
+          (props.filter === undefined || props.filter(p) === true),
       )
       .map((r) =>
         collectFunction({

src/programmers/llm/LlmApplicationProgrammer.ts

@@ -139,6 +139,8 @@ export namespace LlmApplicationProgrammer {
       JsonApplicationProgrammer.write({
         version: "3.1",
         metadata: props.metadata,
+        filter: (p) =>
+          p.jsDocTags.some((tag) => tag.name === "human") === false,
       });
     const functions: Array<ILlmFunction<Model> | null> =
       application.functions.map((func) =>

test/debug.js → test/debug.ts

@@ -1,4 +1,4 @@
-const cp = require("child_process");
+import cp from "child_process";
 
 cp.execSync(`npx ts-node src/debug/${process.argv[2]}.ts`, {
   cwd: __dirname,

test/generate/output/generate_http.ts

@@ -302,15 +302,19 @@ export const validateQuery = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };

test/generate/output/generate_index.ts

@@ -758,15 +758,19 @@ export const validate = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };
@@ -1704,15 +1708,19 @@ export const validateEquals = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };

test/generate/output/generate_json.ts

@@ -605,15 +605,19 @@ export const createValidateStringify = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };
@@ -1098,15 +1102,19 @@ export const createValidateParse = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };

test/generate/output/generate_misc.ts

@@ -567,15 +567,19 @@ export const createValidateClone = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };
@@ -1195,15 +1199,19 @@ export const createValidatePrune = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };

test/generate/output/generate_notations.ts

@@ -546,15 +546,19 @@ export const createValidateCamel = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };
@@ -1098,15 +1102,19 @@ export const createValidatePascal = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };
@@ -1650,15 +1658,19 @@ export const createValidateSnake = (() => {
           value: input,
         }))(input, "$input", true);
       const success = 0 === errors.length;
-      return {
-        success,
-        errors,
-        data: input,
-      } as any;
+      return success
+        ? {
+            success,
+            data: input,
+          }
+        : ({
+            success,
+            errors,
+            data: input,
+          } as any);
     }
     return {
       success: true,
-      errors: [],
       data: input,
     } as any;
   };