@wp-typia/project-tools 0.24.4 → 0.24.5

package/dist/runtime/scaffold.js

@@ -1,255 +1 @@
-import { promises as fsp } from "node:fs";
-import path from "node:path";
-import { getPackageManager } from "./package-managers.js";
-import { buildGitignore, buildReadme, mergeTextLines, removeQueryLoopPlaceholderFiles, replaceTextRecursively, } from "./scaffold-apply-utils.js";
-import { applyGeneratedProjectDxPackageJson, applyLocalDevPresetFiles, } from "./local-dev-presets.js";
-import { runAddIntegrationEnvCommand } from "./cli-add-workspace-integration-env.js";
-import { applyMigrationUiCapability } from "./migration-ui-capability.js";
-import { applyWorkspaceMigrationCapability, ensureScaffoldDirectory, isWorkspaceProject, seedBuiltInPersistenceArtifacts, writeStarterManifestFiles, } from "./scaffold-bootstrap.js";
-import { defaultInstallDependencies, normalizePackageJson, normalizePackageManagerFiles, removeUnexpectedLockfiles, } from "./scaffold-package-manager-files.js";
-import { copyInterpolatedDirectory } from "./template-render.js";
-import { OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE, isBuiltInTemplateId, normalizeTemplateLookupId, } from "./template-registry.js";
-import { resolveTemplateSource } from "./template-source.js";
-import { BlockGeneratorService, } from "./block-generator-service.js";
-import { getTemplateVariables } from "./scaffold-template-variables.js";
-import { getScaffoldTemplateVariableGroups } from "./scaffold-template-variable-groups.js";
-import { assertExternalLayerCompositionOptions, } from "./cli-validation.js";
-import { pathExists } from "./fs-async.js";
-export const DATA_STORAGE_MODES = ["post-meta", "custom-table"];
-export const PERSISTENCE_POLICIES = ["authenticated", "public"];
-/** Supported create profile ids for opt-in workspace scaffold presets. */
-export const CREATE_PROFILE_IDS = ["plugin-qa"];
-export { buildBlockCssClassName } from "./scaffold-identifiers.js";
-export { collectScaffoldAnswers, detectAuthor, getDefaultAnswers, resolvePackageManagerId, resolveTemplateId, } from "./scaffold-answer-resolution.js";
-export { getTemplateVariables } from "./scaffold-template-variables.js";
-export { getScaffoldTemplateVariableGroups, } from "./scaffold-template-variable-groups.js";
-export function isDataStorageMode(value) {
-    return DATA_STORAGE_MODES.includes(value);
-}
-export function isPersistencePolicy(value) {
-    return PERSISTENCE_POLICIES.includes(value);
-}
-/**
- * Return whether a raw string is a supported create profile id.
- */
-export function isCreateProfileId(value) {
-    return CREATE_PROFILE_IDS.includes(value);
-}
-/**
- * Resolve an optional create profile flag into a validated profile id.
- *
- * Empty input disables profile application; unknown ids throw with the allowed
- * profile list for CLI diagnostics.
- */
-export function resolveCreateProfileId(profile) {
-    if (profile === undefined || profile.trim().length === 0) {
-        return undefined;
-    }
-    const normalizedProfile = profile.trim();
-    if (isCreateProfileId(normalizedProfile)) {
-        return normalizedProfile;
-    }
-    throw new Error(`Unknown create profile "${profile}". Expected one of: ${CREATE_PROFILE_IDS.join(", ")}.`);
-}
-function normalizeTemplateSelection(templateId) {
-    return normalizeTemplateLookupId(templateId);
-}
-function assertCreateProfileTemplateCompatibility({ profile, templateId, }) {
-    if (!profile) {
-        return;
-    }
-    if (profile === "plugin-qa" && templateId !== OFFICIAL_WORKSPACE_TEMPLATE_PACKAGE) {
-        throw new Error("`--profile plugin-qa` currently supports only the official workspace template. Use `--template workspace` or add QA files later with `wp-typia add integration-env <name> --wp-env --release-zip`.");
-    }
-}
-async function applyCreateProfile({ profile, projectDir, }) {
-    if (profile !== "plugin-qa") {
-        return;
-    }
-    await runAddIntegrationEnvCommand({
-        cwd: projectDir,
-        integrationEnvName: "local-smoke",
-        service: "none",
-        withReleaseZip: true,
-        withWpEnv: true,
-    });
-}
-async function reportScaffoldProgress(onProgress, event) {
-    await onProgress?.(event);
-}
-export async function scaffoldProject({ projectDir, templateId, answers, alternateRenderTargets, dataStorageMode, persistencePolicy, packageManager, externalLayerId, externalLayerSource, externalLayerSourceLabel, profile, repositoryReference, cwd = process.cwd(), allowExistingDir = false, noInstall = false, installDependencies = undefined, onProgress = undefined, variant, withMigrationUi = false, withTestPreset = false, withWpEnv = false, }) {
-    const resolvedTemplateId = normalizeTemplateSelection(templateId);
-    const resolvedPackageManager = getPackageManager(packageManager).id;
-    const isBuiltInTemplate = isBuiltInTemplateId(resolvedTemplateId);
-    assertCreateProfileTemplateCompatibility({
-        profile,
-        templateId: resolvedTemplateId,
-    });
-    assertExternalLayerCompositionOptions({
-        externalLayerId,
-        externalLayerSource,
-    });
-    if (isBuiltInTemplate) {
-        const blockGeneratorService = new BlockGeneratorService();
-        await reportScaffoldProgress(onProgress, {
-            detail: "Preparing template layers, variants, and generated artifact plans.",
-            phase: "resolve-template",
-            title: "Resolving scaffold template",
-        });
-        const plan = await blockGeneratorService.plan({
-            allowExistingDir,
-            alternateRenderTargets,
-            answers,
-            cwd,
-            dataStorageMode: dataStorageMode ?? answers.dataStorageMode,
-            externalLayerId,
-            externalLayerSource,
-            externalLayerSourceLabel,
-            noInstall,
-            packageManager: resolvedPackageManager,
-            persistencePolicy: persistencePolicy ?? answers.persistencePolicy,
-            projectDir,
-            repositoryReference,
-            templateId: resolvedTemplateId,
-            variant,
-            withMigrationUi,
-            withTestPreset,
-            withWpEnv,
-        });
-        const validated = await blockGeneratorService.validate({ plan });
-        const rendered = await blockGeneratorService.render({ validated });
-        return blockGeneratorService.apply({
-            installDependencies,
-            onProgress,
-            rendered,
-        });
-    }
-    if (externalLayerSource || externalLayerId) {
-        throw new Error("External template layers currently compose only with built-in templates via `wp-typia create --template <basic|interactivity|persistence|compound>` or `wp-typia add block --template <family>`.");
-    }
-    const variables = getTemplateVariables(resolvedTemplateId, {
-        ...answers,
-        dataStorageMode: dataStorageMode ?? answers.dataStorageMode,
-        persistencePolicy: persistencePolicy ?? answers.persistencePolicy,
-    });
-    await reportScaffoldProgress(onProgress, {
-        detail: "Loading template files, variants, and external package metadata when needed.",
-        phase: "resolve-template",
-        title: "Resolving scaffold template",
-    });
-    const templateSource = await resolveTemplateSource(resolvedTemplateId, cwd, variables, variant);
-    const supportsMigrationUi = isBuiltInTemplate ||
-        templateSource.isOfficialWorkspaceTemplate === true ||
-        templateSource.supportsMigrationUi === true;
-    if (withMigrationUi && !supportsMigrationUi) {
-        await templateSource.cleanup?.();
-        throw new Error("`--with-migration-ui` is currently supported only for built-in templates and workspace-capable wp-typia templates.");
-    }
-    try {
-        await reportScaffoldProgress(onProgress, {
-            detail: "Copying scaffold files into the target project directory.",
-            phase: "generate-files",
-            title: "Generating project files",
-        });
-        await ensureScaffoldDirectory(projectDir, allowExistingDir);
-        await copyInterpolatedDirectory(templateSource.templateDir, projectDir, variables);
-    }
-    finally {
-        if (templateSource.cleanup) {
-            await templateSource.cleanup();
-        }
-    }
-    const isWorkspace = isWorkspaceProject(projectDir);
-    if (isBuiltInTemplate) {
-        await reportScaffoldProgress(onProgress, {
-            detail: "Writing starter manifests, local presets, and template-specific generated artifacts.",
-            phase: "seed-artifacts",
-            title: "Seeding scaffold artifacts",
-        });
-        await writeStarterManifestFiles(projectDir, resolvedTemplateId, variables);
-        await seedBuiltInPersistenceArtifacts(projectDir, resolvedTemplateId, variables);
-        await applyLocalDevPresetFiles({
-            projectDir,
-            variables,
-            withTestPreset,
-            withWpEnv,
-        });
-        if (withMigrationUi) {
-            await applyMigrationUiCapability({
-                packageManager: resolvedPackageManager,
-                projectDir,
-                templateId: resolvedTemplateId,
-                variables,
-            });
-        }
-        await removeQueryLoopPlaceholderFiles(projectDir, resolvedTemplateId);
-    }
-    else if (withMigrationUi && isWorkspace) {
-        await reportScaffoldProgress(onProgress, {
-            detail: "Initializing workspace migration scripts and starter migration files.",
-            phase: "seed-artifacts",
-            title: "Seeding scaffold artifacts",
-        });
-        await applyWorkspaceMigrationCapability(projectDir, resolvedPackageManager);
-    }
-    await reportScaffoldProgress(onProgress, {
-        detail: "Writing README, normalizing package metadata, and aligning package-manager files.",
-        phase: "finalize-project",
-        title: "Finalizing scaffold output",
-    });
-    const readmePath = path.join(projectDir, "README.md");
-    if (!(await pathExists(readmePath))) {
-        await fsp.writeFile(readmePath, buildReadme(resolvedTemplateId, variables, resolvedPackageManager, {
-            withMigrationUi: isBuiltInTemplate || isWorkspace ? withMigrationUi : false,
-            withTestPreset: isBuiltInTemplate ? withTestPreset : false,
-            withWpEnv: isBuiltInTemplate ? withWpEnv : false,
-        }), "utf8");
-    }
-    const gitignorePath = path.join(projectDir, ".gitignore");
-    const existingGitignore = (await pathExists(gitignorePath))
-        ? await fsp.readFile(gitignorePath, "utf8")
-        : "";
-    await fsp.writeFile(gitignorePath, mergeTextLines(buildGitignore(), existingGitignore), "utf8");
-    await normalizePackageJson(projectDir, resolvedPackageManager);
-    if (isBuiltInTemplate) {
-        const variableGroups = getScaffoldTemplateVariableGroups(variables);
-        await applyGeneratedProjectDxPackageJson({
-            compoundPersistenceEnabled: variableGroups.compound.enabled &&
-                variableGroups.compound.persistenceEnabled,
-            packageManager: resolvedPackageManager,
-            projectDir,
-            templateId: resolvedTemplateId,
-            withTestPreset,
-            withWpEnv,
-        });
-    }
-    await applyCreateProfile({
-        profile,
-        projectDir,
-    });
-    await normalizePackageManagerFiles(projectDir, resolvedPackageManager);
-    await removeUnexpectedLockfiles(projectDir, resolvedPackageManager);
-    await replaceTextRecursively(projectDir, resolvedPackageManager, {
-        repositoryReference,
-    });
-    if (!noInstall) {
-        await reportScaffoldProgress(onProgress, {
-            detail: "Installing project dependencies with the selected package manager.",
-            phase: "install-dependencies",
-            title: "Installing dependencies",
-        });
-        const installer = installDependencies ?? defaultInstallDependencies;
-        await installer({
-            projectDir,
-            packageManager: resolvedPackageManager,
-        });
-    }
-    return {
-        projectDir,
-        selectedVariant: templateSource.selectedVariant ?? null,
-        templateId: resolvedTemplateId,
-        packageManager: resolvedPackageManager,
-        variables,
-        warnings: templateSource.warnings ?? [],
-    };
-}
+export * from "./templates/scaffold.js";

package/dist/runtime/schema/ai-artifacts.d.ts

@@ -0,0 +1,39 @@
+import type { ArtifactSyncExecutionOptions } from '@wp-typia/block-runtime/metadata-core';
+import { buildWordPressAiArtifacts, type ProjectedWordPressAbilitiesDocument } from './wordpress-ai.js';
+export { buildWordPressAiArtifacts, buildWordPressAbilitiesDocument, projectWordPressAiSchema, } from './wordpress-ai.js';
+export type { AbilityAnnotationSpec, AbilityCategorySpec, AbilityMcpProjectionSpec, AbilityMetaSpec, AbilitySpec, AbilitySpecCatalog, ProjectedWordPressAbilityDefinition, ProjectedWordPressAbilitiesDocument, WordPressAiInputSchemaTransformContext, } from './wordpress-ai.js';
+type BuildWordPressAiArtifactsParameters = Parameters<typeof buildWordPressAiArtifacts>[0];
+/**
+ * Configures where the generated WordPress AI artifacts should be written or
+ * verified on disk.
+ */
+export interface SyncWordPressAiArtifactsOptions extends ArtifactSyncExecutionOptions, BuildWordPressAiArtifactsParameters {
+    /** Destination path for the generated `*.abilities.json` document. */
+    abilitiesDocumentFile: string;
+    /** Destination path for the generated `*.ai.schema.json` document. */
+    aiSchemaFile: string;
+}
+/**
+ * Describes the generated artifact payloads and the file paths they were
+ * written to or verified against.
+ */
+export interface SyncWordPressAiArtifactsResult {
+    /** Generated abilities document content. */
+    abilitiesDocument: ProjectedWordPressAbilitiesDocument;
+    /** Destination path for the generated abilities document. */
+    abilitiesDocumentPath: string;
+    /** Generated AI response schema content. */
+    aiResponseSchema: Record<string, unknown>;
+    /** Destination path for the generated AI response schema. */
+    aiSchemaPath: string;
+    /** True when files were only verified, false when they were written. */
+    check: boolean;
+}
+/**
+ * Builds WordPress AI artifact documents from a manifest-first contract surface
+ * and then writes or verifies the generated JSON files on disk.
+ *
+ * @param options Artifact destinations plus the same manifest/category/schema inputs used by `buildWordPressAiArtifacts()`.
+ * @returns Generated documents and the output file paths that were checked or written.
+ */
+export declare function syncWordPressAiArtifacts({ abilitiesDocumentFile, aiSchemaFile, check, ...buildOptions }: SyncWordPressAiArtifactsOptions): Promise<SyncWordPressAiArtifactsResult>;

package/dist/runtime/schema/ai-artifacts.js

@@ -0,0 +1,67 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { buildWordPressAiArtifacts, } from './wordpress-ai.js';
+import { getOptionalNodeErrorCode, isFileNotFoundError, } from '../shared/fs-async.js';
+export { buildWordPressAiArtifacts, buildWordPressAbilitiesDocument, projectWordPressAiSchema, } from './wordpress-ai.js';
+function normalizeGeneratedArtifactContent(content) {
+    return content.replace(/\r\n?/g, '\n');
+}
+async function reconcileGeneratedAiArtifacts(artifacts, check) {
+    if (!check) {
+        for (const artifact of artifacts) {
+            await mkdir(path.dirname(artifact.filePath), {
+                recursive: true,
+            });
+            await writeFile(artifact.filePath, artifact.content, 'utf8');
+        }
+        return;
+    }
+    const issues = [];
+    for (const artifact of artifacts) {
+        try {
+            const current = normalizeGeneratedArtifactContent(await readFile(artifact.filePath, 'utf8'));
+            const expected = normalizeGeneratedArtifactContent(artifact.content);
+            if (current !== expected) {
+                issues.push(`- ${artifact.filePath} (stale)`);
+            }
+        }
+        catch (error) {
+            if (isFileNotFoundError(error)) {
+                issues.push(`- ${artifact.filePath} (missing)`);
+                continue;
+            }
+            const code = getOptionalNodeErrorCode(error);
+            issues.push(`- ${artifact.filePath} (unreadable: ${error instanceof Error ? error.message : code ?? 'unknown'})`);
+        }
+    }
+    if (issues.length > 0) {
+        throw new Error(`Generated WordPress AI artifacts are missing or stale:\n${issues.join('\n')}`);
+    }
+}
+/**
+ * Builds WordPress AI artifact documents from a manifest-first contract surface
+ * and then writes or verifies the generated JSON files on disk.
+ *
+ * @param options Artifact destinations plus the same manifest/category/schema inputs used by `buildWordPressAiArtifacts()`.
+ * @returns Generated documents and the output file paths that were checked or written.
+ */
+export async function syncWordPressAiArtifacts({ abilitiesDocumentFile, aiSchemaFile, check = false, ...buildOptions }) {
+    const { abilitiesDocument, aiResponseSchema } = await buildWordPressAiArtifacts(buildOptions);
+    await reconcileGeneratedAiArtifacts([
+        {
+            content: `${JSON.stringify(aiResponseSchema, null, 2)}\n`,
+            filePath: aiSchemaFile,
+        },
+        {
+            content: `${JSON.stringify(abilitiesDocument, null, 2)}\n`,
+            filePath: abilitiesDocumentFile,
+        },
+    ], check);
+    return {
+        abilitiesDocument,
+        abilitiesDocumentPath: abilitiesDocumentFile,
+        aiResponseSchema,
+        aiSchemaPath: aiSchemaFile,
+        check,
+    };
+}

package/dist/runtime/schema/metadata-analysis.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports metadata analysis helpers from `@wp-typia/block-runtime`.
+ * This adapter preserves the public project-tools module path while sharing
+ * the runtime implementation with block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-analysis";

package/dist/runtime/schema/metadata-analysis.js

@@ -0,0 +1,7 @@
+/**
+ * Re-exports metadata analysis helpers from `@wp-typia/block-runtime`.
+ * This adapter preserves the public project-tools module path while sharing
+ * the runtime implementation with block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-analysis";

package/dist/runtime/schema/metadata-model.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports the metadata model types and helpers from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-model";

package/dist/runtime/schema/metadata-model.js

@@ -0,0 +1,7 @@
+/**
+ * Re-exports the metadata model types and helpers from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-model";

package/dist/runtime/schema/metadata-parser.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports metadata parser utilities from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-parser";

package/dist/runtime/schema/metadata-parser.js

@@ -0,0 +1,7 @@
+/**
+ * Re-exports metadata parser utilities from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-parser";

package/dist/runtime/schema/metadata-php-render.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports PHP metadata rendering helpers from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-php-render";

package/dist/runtime/schema/metadata-php-render.js

@@ -0,0 +1,7 @@
+/**
+ * Re-exports PHP metadata rendering helpers from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-php-render";

package/dist/runtime/schema/metadata-projection.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports metadata projection utilities from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-projection";

package/dist/runtime/schema/metadata-projection.js

@@ -0,0 +1,7 @@
+/**
+ * Re-exports metadata projection utilities from `@wp-typia/block-runtime`.
+ * This adapter keeps the public project-tools runtime path stable while the
+ * implementation is consolidated in block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/metadata-projection";

package/dist/runtime/schema/schema-core.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Re-exports schema and OpenAPI helpers from `@wp-typia/block-runtime`.
+ * This adapter preserves the public `@wp-typia/project-tools/schema-core`
+ * path while sharing the canonical implementation with block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/schema-core";

package/dist/runtime/schema/schema-core.js

@@ -0,0 +1,7 @@
+/**
+ * Re-exports schema and OpenAPI helpers from `@wp-typia/block-runtime`.
+ * This adapter preserves the public `@wp-typia/project-tools/schema-core`
+ * path while sharing the canonical implementation with block-runtime.
+ * @module
+ */
+export * from "@wp-typia/block-runtime/schema-core";

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

@@ -0,0 +1,24 @@
+import type { JsonSchemaObject } from './schema-core.js';
+/**
+ * Clone a JSON-compatible value when the caller has provided one.
+ *
+ * @template T JSON-compatible value type.
+ * @param value Optional value to clone with the shared JSON clone helper.
+ * @returns A cloned value, or undefined when the input is undefined.
+ */
+export declare function cloneJsonValueIfDefined<T>(value: T | undefined): T | undefined;
+/**
+ * Check whether a candidate is a non-null JSON Schema object.
+ *
+ * @param value Candidate value to narrow.
+ * @returns True when the value is an object and not an array.
+ */
+export declare function isJsonSchemaObject(value: unknown): value is JsonSchemaObject;
+/**
+ * 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;

package/dist/runtime/schema/typia-llm-json-schema.js

@@ -0,0 +1,33 @@
+import { cloneJsonValue } from '../shared/json-utils.js';
+/**
+ * Clone a JSON-compatible value when the caller has provided one.
+ *
+ * @template T JSON-compatible value type.
+ * @param value Optional value to clone with the shared JSON clone helper.
+ * @returns A cloned value, or undefined when the input is undefined.
+ */
+export function cloneJsonValueIfDefined(value) {
+    return value === undefined ? undefined : cloneJsonValue(value);
+}
+/**
+ * Check whether a candidate is a non-null JSON Schema object.
+ *
+ * @param value Candidate value to narrow.
+ * @returns True when the value is an object and not an array.
+ */
+export function isJsonSchemaObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * 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 function assertJsonSchemaObject(value, context) {
+    if (isJsonSchemaObject(value)) {
+        return value;
+    }
+    throw new Error(`${context} must be a JSON Schema object.`);
+}

package/dist/runtime/schema/typia-llm-openapi-constraints.d.ts

@@ -0,0 +1,20 @@
+import type { ApplyOpenApiConstraintsToTypiaLlmFunctionArtifactOptions, ProjectedTypiaLlmFunctionArtifact } from './typia-llm-types.js';
+/**
+ * Clone a projected function artifact before mutation-oriented constraint work.
+ *
+ * @param functionArtifact Projected artifact to clone.
+ * @returns A cloned artifact with parameters and optional output deep-cloned,
+ * and tags shallow-copied when present.
+ */
+export declare function cloneProjectedTypiaLlmFunctionArtifact(functionArtifact: ProjectedTypiaLlmFunctionArtifact): 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;