typia 13.0.0-dev.20260430 → 13.0.0-dev.20260502-2

package/native/core/programmers/llm/LlmParametersProgrammer.go

@@ -1,15 +1,15 @@
 package llm
 
 import (
-	"strings"
+  "strings"
 
-	shimast "github.com/microsoft/typescript-go/shim/ast"
-	nativecontext "github.com/samchon/typia/packages/typia/native/core/context"
-	nativefactories "github.com/samchon/typia/packages/typia/native/core/factories"
-	nativeprogrammers "github.com/samchon/typia/packages/typia/native/core/programmers"
-	nativeiterate "github.com/samchon/typia/packages/typia/native/core/programmers/iterate"
-	nativejson "github.com/samchon/typia/packages/typia/native/core/programmers/json"
-	schemametadata "github.com/samchon/typia/packages/typia/native/core/schemas/metadata"
+  shimast "github.com/microsoft/typescript-go/shim/ast"
+  nativecontext "github.com/samchon/typia/packages/typia/native/core/context"
+  nativefactories "github.com/samchon/typia/packages/typia/native/core/factories"
+  nativeprogrammers "github.com/samchon/typia/packages/typia/native/core/programmers"
+  nativeiterate "github.com/samchon/typia/packages/typia/native/core/programmers/iterate"
+  nativejson "github.com/samchon/typia/packages/typia/native/core/programmers/json"
+  schemametadata "github.com/samchon/typia/packages/typia/native/core/schemas/metadata"
 )
 
 type llmParametersProgrammerNamespace struct{}
@@ -17,152 +17,125 @@ type llmParametersProgrammerNamespace struct{}
 var LlmParametersProgrammer = llmParametersProgrammerNamespace{}
 
 type LlmParametersProgrammer_IProps struct {
-	Context nativecontext.ITypiaContext
-	Modulo  *shimast.Node
-	Type    any
-	Name    *string
-	Init    *shimast.Node
-	Config  map[string]any
+  Context nativecontext.ITypiaContext
+  Modulo  *shimast.Node
+  Type    any
+  Name    *string
+  Init    *shimast.Node
+  Config  map[string]any
 }
 
 type LlmParametersProgrammer_IWriteProps struct {
-	Context  nativecontext.ITypiaContext
-	Metadata *schemametadata.MetadataSchema
-	Config   map[string]any
+  Context  nativecontext.ITypiaContext
+  Metadata *schemametadata.MetadataSchema
+  Config   map[string]any
 }
 
 var llmParametersProgrammer_factory = shimast.NewNodeFactory(shimast.NodeFactoryHooks{})
 
 func (llmParametersProgrammerNamespace) Write(props LlmParametersProgrammer_IWriteProps) *shimast.Node {
-	typeNode := llmProgrammer_import_type(props.Context, nativeprogrammers.ImportProgrammer_TypeProps{
-		File: "typia",
-		Name: llmParametersProgrammer_factory.NewIdentifier("ILlmSchema.IParameters"),
-	})
-	return llmParametersProgrammer_factory.NewAsExpression(
-		llmParametersProgrammer_factory.NewSatisfiesExpression(LlmParametersProgrammer.WriteParametersExpression(props), typeNode),
-		typeNode,
-	)
+  typeNode := llmProgrammer_import_type(props.Context, nativeprogrammers.ImportProgrammer_TypeProps{
+    File: "typia",
+    Name: llmParametersProgrammer_factory.NewIdentifier("ILlmSchema.IParameters"),
+  })
+  return llmParametersProgrammer_factory.NewAsExpression(
+    llmParametersProgrammer_factory.NewSatisfiesExpression(LlmParametersProgrammer.WriteParametersExpression(props), typeNode),
+    typeNode,
+  )
 }
 
 func (llmParametersProgrammerNamespace) WriteParametersExpression(props LlmParametersProgrammer_IWriteProps) *shimast.Node {
-	collection := nativejson.JsonSchemasProgrammer.WriteSchemas(struct {
-		Version   string
-		Metadatas []*schemametadata.MetadataSchema
-	}{
-		Version:   "3.1",
-		Metadatas: []*schemametadata.MetadataSchema{props.Metadata},
-	})
-	if len(collection.Schemas) == 0 {
-		return llmParametersProgrammer_write_parameters_expression(
-			props.Context,
-			&nativeiterate.OpenApi_IComponents{Schemas: map[string]nativeiterate.JsonSchema{}},
-			nativeiterate.JsonSchema{"type": "object", "properties": map[string]any{}, "required": []any{}},
-			props.Config,
-		)
-	}
-	return llmParametersProgrammer_write_parameters_expression(
-		props.Context,
-		collection.Components,
-		llmParametersProgrammer_dereference_schema(collection.Schemas[0], collection.Components),
-		props.Config,
-	)
+  return nativefactories.LiteralFactory.Write(LlmParametersProgrammer.WriteParameters(struct {
+    Metadata *schemametadata.MetadataSchema
+    Config   map[string]any
+  }{
+    Metadata: props.Metadata,
+    Config:   props.Config,
+  }))
 }
 
 func (llmParametersProgrammerNamespace) WriteParameters(props struct {
-	Metadata *schemametadata.MetadataSchema
-	Config   map[string]any
+  Metadata *schemametadata.MetadataSchema
+  Config   map[string]any
 }) map[string]any {
-	collection := nativejson.JsonSchemasProgrammer.WriteSchemas(struct {
-		Version   string
-		Metadatas []*schemametadata.MetadataSchema
-	}{
-		Version:   "3.1",
-		Metadatas: []*schemametadata.MetadataSchema{props.Metadata},
-	})
-	if len(collection.Schemas) == 0 {
-		return map[string]any{"type": "object", "properties": map[string]any{}, "required": []any{}}
-	}
-	schema := collection.Schemas[0]
-	if typ, ok := schema["type"].(string); ok && typ == "object" {
-		return llmParametersProgrammer_convert_parameters(schema, collection.Components)
-	}
-	if ref, ok := schema["$ref"].(string); ok {
-		name := ref[strings.LastIndex(ref, "/")+1:]
-		if collection.Components != nil && collection.Components.Schemas != nil {
-			if target, found := collection.Components.Schemas[name]; found {
-				if typ, ok := target["type"].(string); ok && typ == "object" {
-					return llmParametersProgrammer_convert_parameters(target, collection.Components)
-				}
-			}
-		}
-	}
-	panic("Unreachable code. Failed to find the object schema.")
+  collection := nativejson.JsonSchemasProgrammer.WriteSchemas(struct {
+    Version   string
+    Metadatas []*schemametadata.MetadataSchema
+  }{
+    Version:   "3.1",
+    Metadatas: []*schemametadata.MetadataSchema{props.Metadata},
+  })
+  if len(collection.Schemas) == 0 {
+    return map[string]any{"type": "object", "properties": map[string]any{}, "required": []any{}}
+  }
+  schema := collection.Schemas[0]
+  if typ, ok := schema["type"].(string); ok && typ == "object" {
+    return llmParametersProgrammer_convert_parameters(schema, collection.Components, props.Config)
+  }
+  if ref, ok := schema["$ref"].(string); ok {
+    name := ref[strings.LastIndex(ref, "/")+1:]
+    if collection.Components != nil && collection.Components.Schemas != nil {
+      if target, found := collection.Components.Schemas[name]; found {
+        if typ, ok := target["type"].(string); ok && typ == "object" {
+          return llmParametersProgrammer_convert_parameters(target, collection.Components, props.Config)
+        }
+      }
+    }
+  }
+  panic("Unreachable code. Failed to find the object schema.")
 }
 
 func (llmParametersProgrammerNamespace) Validate(props struct {
-	Config   map[string]any
-	Metadata *schemametadata.MetadataSchema
-	Explore  nativefactories.MetadataFactory_IExplore
+  Config   map[string]any
+  Metadata *schemametadata.MetadataSchema
+  Explore  nativefactories.MetadataFactory_IExplore
 }) []string {
-	output := []string{}
-	if props.Explore.Top == true {
-		if len(props.Metadata.Objects) == 0 {
-			output = append(output, "LLM parameters must be an object type.")
-		} else if len(props.Metadata.Objects) != 1 || props.Metadata.Size() > 1 {
-			output = append(output, "LLM parameters must be a single object type.")
-		} else {
-			for _, property := range props.Metadata.Objects[0].Type.Properties {
-				if property.Key.IsSoleLiteral() == false {
-					output = append(output, "LLM parameters must not have dynamic keys.")
-					break
-				}
-			}
-			if props.Metadata.Nullable {
-				output = append(output, "LLM parameters must be a non-nullable object type.")
-			}
-			if props.Metadata.IsRequired() == false {
-				output = append(output, "LLM parameters must be a non-undefined object type.")
-			}
-		}
-	}
-	output = append(output, LlmSchemaProgrammer.Validate(struct {
-		Config   map[string]any
-		Metadata *schemametadata.MetadataSchema
-		Explore  nativefactories.MetadataFactory_IExplore
-	}{Config: props.Config, Metadata: props.Metadata, Explore: props.Explore})...)
-	return output
+  output := []string{}
+  if props.Explore.Top == true {
+    if len(props.Metadata.Objects) == 0 {
+      output = append(output, "LLM parameters must be an object type.")
+    } else if len(props.Metadata.Objects) != 1 || props.Metadata.Size() > 1 {
+      output = append(output, "LLM parameters must be a single object type.")
+    } else {
+      for _, property := range props.Metadata.Objects[0].Type.Properties {
+        if property.Key.IsSoleLiteral() == false {
+          output = append(output, "LLM parameters must not have dynamic keys.")
+          break
+        }
+      }
+      if props.Metadata.Nullable {
+        output = append(output, "LLM parameters must be a non-nullable object type.")
+      }
+      if props.Metadata.IsRequired() == false {
+        output = append(output, "LLM parameters must be a non-undefined object type.")
+      }
+    }
+  }
+  output = append(output, LlmSchemaProgrammer.Validate(struct {
+    Config   map[string]any
+    Metadata *schemametadata.MetadataSchema
+    Explore  nativefactories.MetadataFactory_IExplore
+  }{Config: props.Config, Metadata: props.Metadata, Explore: props.Explore})...)
+  return output
 }
 
-func llmParametersProgrammer_convert_parameters(schema nativeiterate.JsonSchema, components *nativeiterate.OpenApi_IComponents) map[string]any {
-	defs := map[string]any{}
-	target := llmParametersProgrammer_dereference_schema(schema, components)
-	output := llmSchemaProgrammer_convert_schema(target, components, defs)
-	output["additionalProperties"] = false
-	output["$defs"] = defs
-	return output
-}
-
-func llmParametersProgrammer_write_parameters_expression(
-	context nativecontext.ITypiaContext,
-	components *nativeiterate.OpenApi_IComponents,
-	schema nativeiterate.JsonSchema,
-	config map[string]any,
-) *shimast.Node {
-	return llmProgrammer_converter_result(context, "parameters", "typia.llm.parameters", []*shimast.Node{
-		llmProgrammer_object_property("config", llmProgrammer_config_expression(config)),
-		llmProgrammer_object_property("components", nativefactories.LiteralFactory.Write(components)),
-		llmProgrammer_object_property("schema", nativefactories.LiteralFactory.Write(schema)),
-	})
+func llmParametersProgrammer_convert_parameters(schema nativeiterate.JsonSchema, components *nativeiterate.OpenApi_IComponents, config map[string]any) map[string]any {
+  defs := map[string]any{}
+  target := llmParametersProgrammer_dereference_schema(schema, components)
+  output := llmSchemaProgrammer_convert_schema_config(target, components, defs, config)
+  output["additionalProperties"] = false
+  output["$defs"] = defs
+  return output
 }
 
 func llmParametersProgrammer_dereference_schema(schema nativeiterate.JsonSchema, components *nativeiterate.OpenApi_IComponents) nativeiterate.JsonSchema {
-	ref, ok := schema["$ref"].(string)
-	if ok == false || components == nil || components.Schemas == nil {
-		return schema
-	}
-	name := ref[strings.LastIndex(ref, "/")+1:]
-	if target, found := components.Schemas[name]; found {
-		return target
-	}
-	return schema
+  ref, ok := schema["$ref"].(string)
+  if ok == false || components == nil || components.Schemas == nil {
+    return schema
+  }
+  name := ref[strings.LastIndex(ref, "/")+1:]
+  if target, found := components.Schemas[name]; found {
+    return target
+  }
+  return schema
 }

package/native/core/programmers/llm/LlmParseProgrammer.go

@@ -1,13 +1,13 @@
 package llm
 
 import (
-	shimast "github.com/microsoft/typescript-go/shim/ast"
-	nativecontext "github.com/samchon/typia/packages/typia/native/core/context"
-	nativefactories "github.com/samchon/typia/packages/typia/native/core/factories"
-	nativeprogrammers "github.com/samchon/typia/packages/typia/native/core/programmers"
-	nativehelpers "github.com/samchon/typia/packages/typia/native/core/programmers/helpers"
-	nativeinternal "github.com/samchon/typia/packages/typia/native/core/programmers/internal"
-	schemametadata "github.com/samchon/typia/packages/typia/native/core/schemas/metadata"
+  shimast "github.com/microsoft/typescript-go/shim/ast"
+  nativecontext "github.com/samchon/typia/packages/typia/native/core/context"
+  nativefactories "github.com/samchon/typia/packages/typia/native/core/factories"
+  nativeprogrammers "github.com/samchon/typia/packages/typia/native/core/programmers"
+  nativehelpers "github.com/samchon/typia/packages/typia/native/core/programmers/helpers"
+  nativeinternal "github.com/samchon/typia/packages/typia/native/core/programmers/internal"
+  schemametadata "github.com/samchon/typia/packages/typia/native/core/schemas/metadata"
 )
 
 type llmParseProgrammerNamespace struct{}
@@ -15,106 +15,106 @@ type llmParseProgrammerNamespace struct{}
 var LlmParseProgrammer = llmParseProgrammerNamespace{}
 
 type LlmParseProgrammer_IProps struct {
-	Context nativecontext.ITypiaContext
-	Modulo  *shimast.Node
-	Type    any
-	Name    *string
-	Init    *shimast.Node
-	Config  map[string]any
+  Context nativecontext.ITypiaContext
+  Modulo  *shimast.Node
+  Type    any
+  Name    *string
+  Init    *shimast.Node
+  Config  map[string]any
 }
 
 type LlmParseProgrammer_DecomposeProps struct {
-	Context  nativecontext.ITypiaContext
-	Config   map[string]any
-	Modulo   *shimast.Node
-	Functor  *nativehelpers.FunctionProgrammer
-	Metadata *schemametadata.MetadataSchema
-	Name     *string
+  Context  nativecontext.ITypiaContext
+  Config   map[string]any
+  Modulo   *shimast.Node
+  Functor  *nativehelpers.FunctionProgrammer
+  Metadata *schemametadata.MetadataSchema
+  Name     *string
 }
 
 type LlmParseProgrammer_IWriteProps struct {
-	Context  nativecontext.ITypiaContext
-	Modulo   *shimast.Node
-	Metadata *schemametadata.MetadataSchema
-	Config   map[string]any
-	Name     *string
+  Context  nativecontext.ITypiaContext
+  Modulo   *shimast.Node
+  Metadata *schemametadata.MetadataSchema
+  Config   map[string]any
+  Name     *string
 }
 
 var llmParseProgrammer_factory = shimast.NewNodeFactory(shimast.NodeFactoryHooks{})
 
 func (llmParseProgrammerNamespace) Decompose(props LlmParseProgrammer_DecomposeProps) nativeinternal.FeatureProgrammer_IDecomposed {
-	typeName := "unknown"
-	if props.Name != nil {
-		typeName = *props.Name
-	}
-	return nativeinternal.FeatureProgrammer_IDecomposed{
-		Functions: map[string]*shimast.Node{},
-		Statements: []*shimast.Node{
-			nativefactories.StatementFactory.Constant(nativefactories.StatementFactory_ConstantProps{
-				Name: "__schema",
-				Type: llmProgrammer_import_type(props.Context, ImportTypeIParameters()),
-				Value: LlmParametersProgrammer.WriteParametersExpression(LlmParametersProgrammer_IWriteProps{
-					Context:  props.Context,
-					Metadata: props.Metadata,
-					Config:   props.Config,
-				}),
-			}),
-		},
-		Arrow: llmParseProgrammer_factory.NewArrowFunction(
-			nil,
-			nil,
-			llmParseProgrammer_factory.NewNodeList([]*shimast.Node{
-				nativefactories.IdentifierFactory.Parameter("input", nativefactories.TypeFactory.Keyword("string"), nil),
-			}),
-			llmProgrammer_import_type(props.Context, nativeprogrammers.ImportProgrammer_TypeProps{
-				File:      "typia",
-				Name:      "IJsonParseResult",
-				Arguments: []*shimast.TypeNode{llmProgrammer_type_reference(typeName)},
-			}),
-			nil,
-			llmParseProgrammer_factory.NewToken(shimast.KindEqualsGreaterThanToken),
-			llmParseProgrammer_factory.NewCallExpression(
-				llmProgrammer_internal(props.Context, "parseLlmArguments"),
-				nil,
-				nil,
-				llmParseProgrammer_factory.NewNodeList([]*shimast.Node{
-					llmParseProgrammer_factory.NewIdentifier("input"),
-					llmParseProgrammer_factory.NewIdentifier("__schema"),
-				}),
-				shimast.NodeFlagsNone,
-			),
-		),
-	}
+  typeName := "unknown"
+  if props.Name != nil {
+    typeName = *props.Name
+  }
+  return nativeinternal.FeatureProgrammer_IDecomposed{
+    Functions: map[string]*shimast.Node{},
+    Statements: []*shimast.Node{
+      nativefactories.StatementFactory.Constant(nativefactories.StatementFactory_ConstantProps{
+        Name: "__schema",
+        Type: llmProgrammer_import_type(props.Context, ImportTypeIParameters()),
+        Value: LlmParametersProgrammer.WriteParametersExpression(LlmParametersProgrammer_IWriteProps{
+          Context:  props.Context,
+          Metadata: props.Metadata,
+          Config:   props.Config,
+        }),
+      }),
+    },
+    Arrow: llmParseProgrammer_factory.NewArrowFunction(
+      nil,
+      nil,
+      llmParseProgrammer_factory.NewNodeList([]*shimast.Node{
+        nativefactories.IdentifierFactory.Parameter("input", nativefactories.TypeFactory.Keyword("string"), nil),
+      }),
+      llmProgrammer_import_type(props.Context, nativeprogrammers.ImportProgrammer_TypeProps{
+        File:      "typia",
+        Name:      "IJsonParseResult",
+        Arguments: []*shimast.TypeNode{llmProgrammer_type_reference(typeName)},
+      }),
+      nil,
+      llmParseProgrammer_factory.NewToken(shimast.KindEqualsGreaterThanToken),
+      llmParseProgrammer_factory.NewCallExpression(
+        llmProgrammer_internal(props.Context, "parseLlmArguments"),
+        nil,
+        nil,
+        llmParseProgrammer_factory.NewNodeList([]*shimast.Node{
+          llmParseProgrammer_factory.NewIdentifier("input"),
+          llmParseProgrammer_factory.NewIdentifier("__schema"),
+        }),
+        shimast.NodeFlagsNone,
+      ),
+    ),
+  }
 }
 
 func (llmParseProgrammerNamespace) Write(props LlmParseProgrammer_IWriteProps) *shimast.Node {
-	functor := nativehelpers.NewFunctionProgrammer(llmProgrammer_method_text(props.Modulo))
-	result := LlmParseProgrammer.Decompose(LlmParseProgrammer_DecomposeProps{
-		Context:  props.Context,
-		Config:   props.Config,
-		Modulo:   props.Modulo,
-		Functor:  functor,
-		Metadata: props.Metadata,
-		Name:     props.Name,
-	})
-	return nativeinternal.FeatureProgrammer.WriteDecomposed(nativeinternal.FeatureProgrammer_WriteDecomposedProps{
-		Modulo:  props.Modulo,
-		Functor: functor,
-		Result:  result,
-	})
+  functor := nativehelpers.NewFunctionProgrammer(llmProgrammer_method_text(props.Modulo))
+  result := LlmParseProgrammer.Decompose(LlmParseProgrammer_DecomposeProps{
+    Context:  props.Context,
+    Config:   props.Config,
+    Modulo:   props.Modulo,
+    Functor:  functor,
+    Metadata: props.Metadata,
+    Name:     props.Name,
+  })
+  return nativeinternal.FeatureProgrammer.WriteDecomposed(nativeinternal.FeatureProgrammer_WriteDecomposedProps{
+    Modulo:  props.Modulo,
+    Functor: functor,
+    Result:  result,
+  })
 }
 
 func (llmParseProgrammerNamespace) Validate(props struct {
-	Config   map[string]any
-	Metadata *schemametadata.MetadataSchema
-	Explore  nativefactories.MetadataFactory_IExplore
+  Config   map[string]any
+  Metadata *schemametadata.MetadataSchema
+  Explore  nativefactories.MetadataFactory_IExplore
 }) []string {
-	return LlmParametersProgrammer.Validate(props)
+  return LlmParametersProgrammer.Validate(props)
 }
 
 func ImportTypeIParameters() nativeprogrammers.ImportProgrammer_TypeProps {
-	return nativeprogrammers.ImportProgrammer_TypeProps{
-		File: "typia",
-		Name: llmParseProgrammer_factory.NewIdentifier("ILlmSchema.IParameters"),
-	}
+  return nativeprogrammers.ImportProgrammer_TypeProps{
+    File: "typia",
+    Name: llmParseProgrammer_factory.NewIdentifier("ILlmSchema.IParameters"),
+  }
 }