@wp-typia/project-tools 0.23.0 → 0.24.0

package/dist/runtime/typia-llm-types.d.ts

@@ -0,0 +1,197 @@
+import type { ArtifactSyncExecutionOptions, EndpointManifestDefinition, EndpointManifestEndpointDefinition } from '@wp-typia/block-runtime/metadata-core';
+import type { ILlmFunction, ILlmSchema, ILlmStructuredOutput } from 'typia';
+import type { EndpointAuthIntent, EndpointWordPressAuthDefinition, OpenApiDocument } from './schema-core.js';
+/**
+ * Method-level descriptor projected from an endpoint manifest for a generated
+ * `typia.llm` controller interface.
+ */
+export interface TypiaLlmEndpointMethodDescriptor {
+    /** Normalized auth intent derived from the endpoint manifest. */
+    authIntent: EndpointAuthIntent;
+    /** Optional auth mode propagated from legacy manifest metadata. */
+    authMode?: EndpointManifestEndpointDefinition['authMode'];
+    /** Human-readable operation summary. */
+    description?: string;
+    /** Input type used by the generated controller method, or null for no input. */
+    inputTypeName: string | null;
+    /** Type names that must be imported when inputTypeName is an inline composite. */
+    inputTypeImportNames?: readonly string[];
+    /** HTTP method from the source endpoint manifest. */
+    method: EndpointManifestEndpointDefinition['method'];
+    /** Stable operation identifier used as the generated method name. */
+    operationId: string;
+    /** Output type used by the generated controller method. */
+    outputTypeName: string;
+    /** REST path from the source endpoint manifest. */
+    path: string;
+    /** Tags copied from the source endpoint manifest. */
+    tags: readonly string[];
+    /** Optional WordPress auth overlay preserved for downstream adapters. */
+    wordpressAuth?: EndpointWordPressAuthDefinition;
+}
+/**
+ * Configures the generated TypeScript module that asks `typia.llm` to derive
+ * function-calling and structured-output artifacts from canonical contracts.
+ */
+export interface RenderTypiaLlmModuleOptions {
+    /** Export name for the generated `typia.llm.application<...>()` value. */
+    applicationExportName: string;
+    /** Generated controller interface name. */
+    interfaceName: string;
+    /** Endpoint manifest that owns REST operation metadata and source type names. */
+    manifest: EndpointManifestDefinition;
+    /** Export name for the generated `typia.llm.structuredOutput<...>()` value. */
+    structuredOutputExportName: string;
+    /** TypeScript output type used for structured-output projection. */
+    structuredOutputTypeName: string;
+    /** Import path from the generated module to the canonical TypeScript contracts. */
+    typesImportPath: string;
+}
+/**
+ * Configures writing or checking the generated `typia.llm` adapter module.
+ */
+export interface SyncTypiaLlmAdapterModuleOptions extends ArtifactSyncExecutionOptions, RenderTypiaLlmModuleOptions {
+    /** Destination path for the generated TypeScript adapter module. */
+    generatedSourceFile: string;
+}
+/**
+ * Describes the generated adapter module and where it was written or checked.
+ */
+export interface SyncTypiaLlmAdapterModuleResult {
+    /** True when the source file was only verified, false when it was written. */
+    check: boolean;
+    /** Generated endpoint method descriptors used by the module renderer. */
+    methodDescriptors: TypiaLlmEndpointMethodDescriptor[];
+    /** Rendered TypeScript module source. */
+    source: string;
+    /** Destination path for the generated TypeScript adapter module. */
+    sourceFile: string;
+}
+/**
+ * Function schema shape projected from a compiled `typia.llm.application(...)`
+ * result.
+ */
+export interface TypiaLlmFunctionLike extends Pick<ILlmFunction, 'description' | 'name' | 'output' | 'parameters'> {
+    /** Function description generated by `typia.llm`. */
+    description?: string;
+    /** Function name generated by `typia.llm`. */
+    name: string;
+    /** Optional output schema generated by `typia.llm`. */
+    output?: ILlmSchema.IParameters;
+    /** Function parameter schema generated by `typia.llm`. */
+    parameters: ILlmSchema.IParameters;
+    /** Optional tags generated by `typia.llm`. */
+    tags?: readonly string[];
+}
+/**
+ * Application shape projected from a compiled `typia.llm.application(...)`
+ * result.
+ */
+export interface TypiaLlmApplicationLike {
+    /** Function schemas generated by `typia.llm`. */
+    functions: readonly TypiaLlmFunctionLike[];
+}
+/**
+ * Structured-output shape projected from a compiled
+ * `typia.llm.structuredOutput(...)` result.
+ */
+export interface TypiaLlmStructuredOutputLike extends Pick<ILlmStructuredOutput, 'parameters'> {
+    /** Structured output parameters generated by `typia.llm`. */
+    parameters: ILlmStructuredOutput['parameters'];
+}
+/**
+ * JSON-friendly function artifact for downstream adapter consumers.
+ */
+export interface ProjectedTypiaLlmFunctionArtifact {
+    /** Function description generated by `typia.llm`. */
+    description?: string;
+    /** Function name generated by `typia.llm`. */
+    name: string;
+    /** Optional output schema generated by `typia.llm`. */
+    output?: ILlmSchema.IParameters;
+    /** Function parameter schema generated by `typia.llm`. */
+    parameters: ILlmSchema.IParameters;
+    /** Optional tags generated by `typia.llm`. */
+    tags?: string[];
+}
+/**
+ * JSON-friendly application artifact for downstream adapter consumers.
+ */
+export interface ProjectedTypiaLlmApplicationArtifact {
+    /** Function-calling artifacts generated by `typia.llm`. */
+    functions: ProjectedTypiaLlmFunctionArtifact[];
+    /** Source metadata that keeps the artifact tied to canonical contracts. */
+    generatedFrom: {
+        baselineOpenApiPath?: string;
+        blockSlug: string;
+        manifestSource: 'endpoint-manifest+typescript';
+    };
+}
+/**
+ * JSON-friendly structured-output artifact for downstream adapter consumers.
+ */
+export interface ProjectedTypiaLlmStructuredOutputArtifact {
+    /** Source metadata that keeps the artifact tied to canonical contracts. */
+    generatedFrom: {
+        aiSchemaPath?: string;
+        blockSlug: string;
+        outputTypeName: string;
+    };
+    /** Structured output parameters generated by `typia.llm`. */
+    parameters: ILlmStructuredOutput['parameters'];
+}
+/**
+ * Configures optional OpenAPI-backed constraint restoration for projected
+ * `typia.llm` function artifacts.
+ */
+export interface ProjectTypiaLlmOpenApiProjectionOptions {
+    /** Canonical endpoint-aware OpenAPI document for the projected contracts. */
+    openApiDocument: OpenApiDocument;
+    /** Optional override for resolving one function schema to an operation id. */
+    resolveOperationId?: (functionSchema: TypiaLlmFunctionLike, functionArtifact: ProjectedTypiaLlmFunctionArtifact) => string;
+}
+/**
+ * Configures projection of a compiled `typia.llm.application(...)` result into
+ * the JSON-friendly adapter artifact.
+ */
+export interface ProjectTypiaLlmApplicationArtifactOptions {
+    /** Compiled application value produced by `typia.llm.application(...)`. */
+    application: TypiaLlmApplicationLike;
+    /** Source metadata for the generated JSON artifact. */
+    generatedFrom: ProjectedTypiaLlmApplicationArtifact['generatedFrom'];
+    /** Optional OpenAPI projection that restores canonical schema constraints. */
+    openApiProjection?: ProjectTypiaLlmOpenApiProjectionOptions;
+    /** Optional hook for adapter-specific function schema normalization. */
+    transformFunction?: (functionArtifact: ProjectedTypiaLlmFunctionArtifact, functionSchema: TypiaLlmFunctionLike) => ProjectedTypiaLlmFunctionArtifact;
+}
+/**
+ * Configures direct OpenAPI-backed constraint restoration for one projected
+ * function artifact.
+ */
+export interface ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions {
+    /** Projected function artifact to enrich with canonical constraints. */
+    functionArtifact: ProjectedTypiaLlmFunctionArtifact;
+    /** Canonical endpoint-aware OpenAPI document. */
+    openApiDocument: OpenApiDocument;
+    /** Operation id that owns the request/response contract for this function. */
+    operationId: string;
+}
+/**
+ * Configures projection of a compiled `typia.llm.structuredOutput(...)` result
+ * into the JSON-friendly adapter artifact.
+ */
+export interface ProjectTypiaLlmStructuredOutputArtifactOptions {
+    /** Source metadata for the generated JSON artifact. */
+    generatedFrom: ProjectedTypiaLlmStructuredOutputArtifact['generatedFrom'];
+    /** Compiled structured-output value produced by `typia.llm.structuredOutput(...)`. */
+    structuredOutput: TypiaLlmStructuredOutputLike;
+}
+/**
+ * Generated Typia LLM artifact payload and destination.
+ */
+export type GeneratedTypiaLlmArtifactFile = {
+    /** File contents to write or compare. */
+    content: string;
+    /** Destination path for the generated artifact file. */
+    filePath: string;
+};

package/dist/runtime/typia-llm-types.js

@@ -0,0 +1 @@
+export {};

package/dist/runtime/typia-llm.d.ts

@@ -1,258 +1,12 @@
-import type { ArtifactSyncExecutionOptions, EndpointManifestDefinition, EndpointManifestEndpointDefinition } from '@wp-typia/block-runtime/metadata-core';
-import type { ILlmFunction, ILlmSchema, ILlmStructuredOutput } from 'typia';
-import { type EndpointAuthIntent, type EndpointWordPressAuthDefinition, type JsonSchemaObject, type OpenApiDocument } from './schema-core.js';
 /**
- * Method-level descriptor projected from an endpoint manifest for a generated
- * `typia.llm` controller interface.
- */
-export interface TypiaLlmEndpointMethodDescriptor {
-    /** Normalized auth intent derived from the endpoint manifest. */
-    authIntent: EndpointAuthIntent;
-    /** Optional auth mode propagated from legacy manifest metadata. */
-    authMode?: EndpointManifestEndpointDefinition['authMode'];
-    /** Human-readable operation summary. */
-    description?: string;
-    /** Input type used by the generated controller method, or null for no input. */
-    inputTypeName: string | null;
-    /** Type names that must be imported when inputTypeName is an inline composite. */
-    inputTypeImportNames?: readonly string[];
-    /** HTTP method from the source endpoint manifest. */
-    method: EndpointManifestEndpointDefinition['method'];
-    /** Stable operation identifier used as the generated method name. */
-    operationId: string;
-    /** Output type used by the generated controller method. */
-    outputTypeName: string;
-    /** REST path from the source endpoint manifest. */
-    path: string;
-    /** Tags copied from the source endpoint manifest. */
-    tags: readonly string[];
-    /** Optional WordPress auth overlay preserved for downstream adapters. */
-    wordpressAuth?: EndpointWordPressAuthDefinition;
-}
-/**
- * Configures the generated TypeScript module that asks `typia.llm` to derive
- * function-calling and structured-output artifacts from canonical contracts.
- */
-export interface RenderTypiaLlmModuleOptions {
-    /** Export name for the generated `typia.llm.application<...>()` value. */
-    applicationExportName: string;
-    /** Generated controller interface name. */
-    interfaceName: string;
-    /** Endpoint manifest that owns REST operation metadata and source type names. */
-    manifest: EndpointManifestDefinition;
-    /** Export name for the generated `typia.llm.structuredOutput<...>()` value. */
-    structuredOutputExportName: string;
-    /** TypeScript output type used for structured-output projection. */
-    structuredOutputTypeName: string;
-    /** Import path from the generated module to the canonical TypeScript contracts. */
-    typesImportPath: string;
-}
-/**
- * Configures writing or checking the generated `typia.llm` adapter module.
- */
-export interface SyncTypiaLlmAdapterModuleOptions extends ArtifactSyncExecutionOptions, RenderTypiaLlmModuleOptions {
-    /** Destination path for the generated TypeScript adapter module. */
-    generatedSourceFile: string;
-}
-/**
- * Describes the generated adapter module and where it was written or checked.
- */
-export interface SyncTypiaLlmAdapterModuleResult {
-    /** True when the source file was only verified, false when it was written. */
-    check: boolean;
-    /** Generated endpoint method descriptors used by the module renderer. */
-    methodDescriptors: TypiaLlmEndpointMethodDescriptor[];
-    /** Rendered TypeScript module source. */
-    source: string;
-    /** Destination path for the generated TypeScript adapter module. */
-    sourceFile: string;
-}
-/**
- * Function schema shape projected from a compiled `typia.llm.application(...)`
- * result.
- */
-export interface TypiaLlmFunctionLike extends Pick<ILlmFunction, 'description' | 'name' | 'output' | 'parameters'> {
-    /** Function description generated by `typia.llm`. */
-    description?: string;
-    /** Function name generated by `typia.llm`. */
-    name: string;
-    /** Optional output schema generated by `typia.llm`. */
-    output?: ILlmSchema.IParameters;
-    /** Function parameter schema generated by `typia.llm`. */
-    parameters: ILlmSchema.IParameters;
-    /** Optional tags generated by `typia.llm`. */
-    tags?: readonly string[];
-}
-/**
- * Application shape projected from a compiled `typia.llm.application(...)`
- * result.
- */
-export interface TypiaLlmApplicationLike {
-    /** Function schemas generated by `typia.llm`. */
-    functions: readonly TypiaLlmFunctionLike[];
-}
-/**
- * Structured-output shape projected from a compiled
- * `typia.llm.structuredOutput(...)` result.
- */
-export interface TypiaLlmStructuredOutputLike extends Pick<ILlmStructuredOutput, 'parameters'> {
-    /** Structured output parameters generated by `typia.llm`. */
-    parameters: ILlmStructuredOutput['parameters'];
-}
-/**
- * JSON-friendly function artifact for downstream adapter consumers.
- */
-export interface ProjectedTypiaLlmFunctionArtifact {
-    /** Function description generated by `typia.llm`. */
-    description?: string;
-    /** Function name generated by `typia.llm`. */
-    name: string;
-    /** Optional output schema generated by `typia.llm`. */
-    output?: ILlmSchema.IParameters;
-    /** Function parameter schema generated by `typia.llm`. */
-    parameters: ILlmSchema.IParameters;
-    /** Optional tags generated by `typia.llm`. */
-    tags?: string[];
-}
-/**
- * JSON-friendly application artifact for downstream adapter consumers.
- */
-export interface ProjectedTypiaLlmApplicationArtifact {
-    /** Function-calling artifacts generated by `typia.llm`. */
-    functions: ProjectedTypiaLlmFunctionArtifact[];
-    /** Source metadata that keeps the artifact tied to canonical contracts. */
-    generatedFrom: {
-        baselineOpenApiPath?: string;
-        blockSlug: string;
-        manifestSource: 'endpoint-manifest+typescript';
-    };
-}
-/**
- * JSON-friendly structured-output artifact for downstream adapter consumers.
- */
-export interface ProjectedTypiaLlmStructuredOutputArtifact {
-    /** Source metadata that keeps the artifact tied to canonical contracts. */
-    generatedFrom: {
-        aiSchemaPath?: string;
-        blockSlug: string;
-        outputTypeName: string;
-    };
-    /** Structured output parameters generated by `typia.llm`. */
-    parameters: ILlmStructuredOutput['parameters'];
-}
-/**
- * Configures optional OpenAPI-backed constraint restoration for projected
- * `typia.llm` function artifacts.
- */
-export interface ProjectTypiaLlmOpenApiProjectionOptions {
-    /** Canonical endpoint-aware OpenAPI document for the projected contracts. */
-    openApiDocument: OpenApiDocument;
-    /** Optional override for resolving one function schema to an operation id. */
-    resolveOperationId?: (functionSchema: TypiaLlmFunctionLike, functionArtifact: ProjectedTypiaLlmFunctionArtifact) => string;
-}
-/**
- * Configures projection of a compiled `typia.llm.application(...)` result into
- * the JSON-friendly adapter artifact.
- */
-export interface ProjectTypiaLlmApplicationArtifactOptions {
-    /** Compiled application value produced by `typia.llm.application(...)`. */
-    application: TypiaLlmApplicationLike;
-    /** Source metadata for the generated JSON artifact. */
-    generatedFrom: ProjectedTypiaLlmApplicationArtifact['generatedFrom'];
-    /** Optional OpenAPI projection that restores canonical schema constraints. */
-    openApiProjection?: ProjectTypiaLlmOpenApiProjectionOptions;
-    /** Optional hook for adapter-specific function schema normalization. */
-    transformFunction?: (functionArtifact: ProjectedTypiaLlmFunctionArtifact, functionSchema: TypiaLlmFunctionLike) => ProjectedTypiaLlmFunctionArtifact;
-}
-/**
- * Configures direct OpenAPI-backed constraint restoration for one projected
- * function artifact.
- */
-export interface ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions {
-    /** Projected function artifact to enrich with canonical constraints. */
-    functionArtifact: ProjectedTypiaLlmFunctionArtifact;
-    /** Canonical endpoint-aware OpenAPI document. */
-    openApiDocument: OpenApiDocument;
-    /** Operation id that owns the request/response contract for this function. */
-    operationId: string;
-}
-/**
- * Configures projection of a compiled `typia.llm.structuredOutput(...)` result
- * into the JSON-friendly adapter artifact.
- */
-export interface ProjectTypiaLlmStructuredOutputArtifactOptions {
-    /** Source metadata for the generated JSON artifact. */
-    generatedFrom: ProjectedTypiaLlmStructuredOutputArtifact['generatedFrom'];
-    /** Compiled structured-output value produced by `typia.llm.structuredOutput(...)`. */
-    structuredOutput: TypiaLlmStructuredOutputLike;
-}
-/**
- * Narrow a `typia.llm` artifact field before applying JSON Schema mutations.
- *
- * @param value Candidate schema value emitted by `typia.llm`.
- * @param context Human-readable artifact path for diagnostics.
- * @returns The value narrowed to the shared JSON Schema object shape.
- */
-export declare function assertJsonSchemaObject(value: unknown, context: string): JsonSchemaObject;
-/**
- * Builds the generated controller method descriptors that bridge endpoint
- * manifests to `typia.llm` TypeScript interfaces.
- *
- * @param manifest Endpoint manifest that owns operation and source type names.
- * @returns Ordered method descriptors matching the manifest endpoints.
- * @throws When an endpoint has ambiguous query/body input mapping.
- * @throws When an endpoint references a missing input or output contract.
- */
-export declare function buildTypiaLlmEndpointMethodDescriptors(manifest: EndpointManifestDefinition): TypiaLlmEndpointMethodDescriptor[];
-/**
- * Renders a build-time-only TypeScript module that invokes `typia.llm` against
- * canonical manifest-owned contracts.
- *
- * @param options Render options for the generated adapter module.
- * @returns The generated TypeScript source.
- */
-export declare function renderTypiaLlmModule({ applicationExportName, interfaceName, manifest, structuredOutputExportName, structuredOutputTypeName, typesImportPath, }: RenderTypiaLlmModuleOptions): string;
-/**
- * Writes or verifies the generated build-time `typia.llm` adapter module. The
- * returned TypeScript source still needs to be compiled by the consuming
- * project's Typia transformer before JSON artifacts can be read from it.
- *
- * @param options Generated module destination plus render options.
- * @returns Rendered source, method descriptors, and the checked/written file path.
- */
-export declare function syncTypiaLlmAdapterModule({ check, generatedSourceFile, ...renderOptions }: SyncTypiaLlmAdapterModuleOptions): Promise<SyncTypiaLlmAdapterModuleResult>;
-/**
- * Projects one compiled `typia.llm` function schema into a JSON-friendly
- * artifact record.
- *
- * @param functionSchema Function schema from a compiled `typia.llm.application(...)`.
- * @returns JSON-friendly function artifact.
- */
-export declare function projectTypiaLlmApplicationFunction(functionSchema: TypiaLlmFunctionLike): ProjectedTypiaLlmFunctionArtifact;
-/**
- * Restores canonical request and response constraints from an endpoint-aware
- * OpenAPI document onto one projected `typia.llm` function artifact.
- *
- * Query-only inputs merge into the root parameter object. Mixed body/query
- * inputs merge into the generated `body` and `query` properties.
- *
- * @param options Projected artifact plus the canonical OpenAPI document.
- * @returns A cloned artifact enriched with OpenAPI-backed constraints when available.
- */
-export declare function applyOpenApiConstraintsToTypiaLlmFunctionArtifact({ functionArtifact, openApiDocument, operationId, }: ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions): ProjectedTypiaLlmFunctionArtifact;
-/**
- * Projects a compiled `typia.llm.application(...)` result into a JSON-friendly
- * downstream adapter artifact.
- *
- * @param options Compiled application value and source metadata.
- * @returns JSON-friendly application artifact.
- */
-export declare function projectTypiaLlmApplicationArtifact({ application, generatedFrom, openApiProjection, transformFunction, }: ProjectTypiaLlmApplicationArtifactOptions): ProjectedTypiaLlmApplicationArtifact;
-/**
- * Projects a compiled `typia.llm.structuredOutput(...)` result into a
- * JSON-friendly downstream adapter artifact.
+ * Public compatibility facade for Typia LLM runtime helpers.
  *
- * @param options Compiled structured-output value and source metadata.
- * @returns JSON-friendly structured-output artifact.
+ * Keep `@wp-typia/project-tools/typia-llm` stable while rendering, sync,
+ * projection, and OpenAPI constraint restoration live in focused modules.
  */
-export declare function projectTypiaLlmStructuredOutputArtifact({ generatedFrom, structuredOutput, }: ProjectTypiaLlmStructuredOutputArtifactOptions): ProjectedTypiaLlmStructuredOutputArtifact;
+export type { ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions, ProjectedTypiaLlmApplicationArtifact, ProjectedTypiaLlmFunctionArtifact, ProjectedTypiaLlmStructuredOutputArtifact, ProjectTypiaLlmApplicationArtifactOptions, ProjectTypiaLlmOpenApiProjectionOptions, ProjectTypiaLlmStructuredOutputArtifactOptions, RenderTypiaLlmModuleOptions, SyncTypiaLlmAdapterModuleOptions, SyncTypiaLlmAdapterModuleResult, TypiaLlmApplicationLike, TypiaLlmEndpointMethodDescriptor, TypiaLlmFunctionLike, TypiaLlmStructuredOutputLike, } from './typia-llm-types.js';
+export { assertJsonSchemaObject } from './typia-llm-json-schema.js';
+export { applyOpenApiConstraintsToTypiaLlmFunctionArtifact, } from './typia-llm-openapi-constraints.js';
+export { projectTypiaLlmApplicationArtifact, projectTypiaLlmApplicationFunction, projectTypiaLlmStructuredOutputArtifact, } from './typia-llm-projection.js';
+export { buildTypiaLlmEndpointMethodDescriptors, renderTypiaLlmModule, } from './typia-llm-render.js';
+export { syncTypiaLlmAdapterModule } from './typia-llm-sync.js';