@caatinga/core 2.2.1 → 2.3.0

package/dist/index.cjs

@@ -66,6 +66,7 @@ __export(index_exports, {
   readArtifacts: () => readArtifacts,
   readBindingMarker: () => readBindingMarker,
   resolveContract: () => resolveContract,
+  resolveDefaultContractName: () => resolveDefaultContractName,
   resolveDeployArgs: () => resolveDeployArgs,
   resolveDeployOrder: () => resolveDeployOrder,
   resolveNetwork: () => resolveNetwork,
@@ -185,7 +186,7 @@ function formatCause(cause) {
 }
 
 // src/version.ts
-var CAATINGA_CORE_VERSION = "2.2.1";
+var CAATINGA_CORE_VERSION = "2.3.0";
 
 // src/config/config.schema.ts
 var import_zod = require("zod");
@@ -200,6 +201,15 @@ var NetworkConfigSchema = import_zod.z.object({
   rpcUrl: import_zod.z.string().url(),
   networkPassphrase: import_zod.z.string().min(1)
 });
+var ZkCircuitSchema = import_zod.z.object({
+  path: import_zod.z.string().min(1),
+  protocol: import_zod.z.literal("groth16"),
+  curve: import_zod.z.literal("bls12381"),
+  verifierContract: import_zod.z.string().optional()
+});
+var ZkConfigSchema = import_zod.z.object({
+  circuits: import_zod.z.record(import_zod.z.string().min(1), ZkCircuitSchema)
+}).optional();
 var CaatingaConfigSchema = import_zod.z.object({
   project: import_zod.z.string().min(1),
   defaultNetwork: import_zod.z.string().min(1).default("testnet"),
@@ -214,7 +224,8 @@ var CaatingaConfigSchema = import_zod.z.object({
   frontend: import_zod.z.object({
     framework: import_zod.z.enum(["vite-react", "next", "astro"]).default("vite-react"),
     bindingsOutput: import_zod.z.string().min(1)
-  })
+  }),
+  zk: ZkConfigSchema
 });
 
 // src/config/define-config.ts
@@ -658,6 +669,7 @@ async function runCommand(command, args, options = {}) {
     const result = await (0, import_execa.execa)(command, args, {
       cwd: options.cwd,
       env: options.env,
+      input: options.input,
       all: true,
       reject: true
     });
@@ -872,6 +884,19 @@ function resolveContract(config, contractName, cwd = process.cwd()) {
   };
 }
 
+// src/contracts/resolve-default-contract.ts
+function resolveDefaultContractName(config) {
+  const names = Object.keys(config.contracts);
+  if (names.length === 1) {
+    return names[0];
+  }
+  throw new CaatingaError(
+    "Pass a contract name to build.",
+    CaatingaErrorCode.CONTRACT_NOT_FOUND,
+    `Configured contracts: ${names.join(", ")}. Example: caatinga build ${names[0]}`
+  );
+}
+
 // src/contracts/wasm.ts
 var import_node_crypto = require("crypto");
 var import_promises6 = require("fs/promises");
@@ -1662,15 +1687,18 @@ async function createProjectFromTemplate(options) {
     );
   }
   const manifest = await readTemplateManifest(templateDir);
+  const mergeIntoExisting = Boolean(options.filter);
   await (0, import_promises8.mkdir)(targetDir, { recursive: true });
   await (0, import_promises8.cp)(templateDir, targetDir, {
     recursive: true,
-    force: false,
-    errorOnExist: true,
-    filter: (source) => shouldCopyTemplateEntry(templateDir, source)
+    force: mergeIntoExisting,
+    errorOnExist: !mergeIntoExisting,
+    filter: (source) => shouldCopyTemplateEntry(templateDir, source, options.filter)
   });
   await replaceTemplateVariables(targetDir, options.projectName);
-  await ensureArtifacts(targetDir, options.projectName);
+  if (!mergeIntoExisting) {
+    await ensureArtifacts(targetDir, options.projectName);
+  }
   return { targetDir, template: manifest };
 }
 async function ensureArtifacts(targetDir, projectName) {
@@ -1736,11 +1764,15 @@ async function replaceTemplateVariables(dir, projectName) {
     await (0, import_promises8.writeFile)(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
   }));
 }
-function shouldCopyTemplateEntry(templateDir, source) {
+function shouldCopyTemplateEntry(templateDir, source, userFilter) {
   const relativePath = import_node_path10.default.relative(templateDir, source);
   if (!relativePath || relativePath === ".") {
     return true;
   }
+  const normalizedPath = relativePath.split(import_node_path10.default.sep).join("/");
+  if (userFilter && !userFilter(normalizedPath)) {
+    return false;
+  }
   return !relativePath.split(import_node_path10.default.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
 }
 function isTextTemplateFile(filePath) {
@@ -1814,6 +1846,7 @@ function isTransientTestnetSmokeFailure(logText) {
   readArtifacts,
   readBindingMarker,
   resolveContract,
+  resolveDefaultContractName,
   resolveDeployArgs,
   resolveDeployOrder,
   resolveNetwork,

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeVa
 export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.cjs';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.2.1";
+declare const CAATINGA_CORE_VERSION = "2.3.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -85,6 +85,38 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
     }>;
+    zk: z.ZodOptional<z.ZodObject<{
+        circuits: z.ZodRecord<z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            protocol: z.ZodLiteral<"groth16">;
+            curve: z.ZodLiteral<"bls12381">;
+            verifierContract: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    }, {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     project: string;
     defaultNetwork: string;
@@ -102,6 +134,14 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         framework: "vite-react" | "next" | "astro";
         bindingsOutput: string;
     };
+    zk?: {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    } | undefined;
 }, {
     project: string;
     contracts: Record<string, {
@@ -119,6 +159,14 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         framework?: "vite-react" | "next" | "astro" | undefined;
     };
     defaultNetwork?: string | undefined;
+    zk?: {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    } | undefined;
 }>;
 type CaatingaConfig = z.infer<typeof CaatingaConfigSchema>;
 type ContractConfig = z.infer<typeof ContractConfigSchema>;
@@ -232,6 +280,7 @@ type RunCommandResult = {
 type RunCommandOptions = {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
+    input?: string;
     skipStellarVersionCheck?: boolean;
     failureCode?: CaatingaErrorCodeValue;
 };
@@ -286,6 +335,8 @@ type ResolvedContract = {
 };
 declare function resolveContract(config: CaatingaConfig, contractName: string, cwd?: string): ResolvedContract;
 
+declare function resolveDefaultContractName(config: CaatingaConfig): string;
+
 type BuildContractOptions = {
     config: CaatingaConfig;
     contractName: string;
@@ -444,6 +495,7 @@ type CreateProjectFromTemplateOptions = {
     projectName: string;
     targetDir: string;
     templateDir: string;
+    filter?: (relativePath: string) => boolean;
 };
 declare function createProjectFromTemplate(options: CreateProjectFromTemplateOptions): Promise<{
     targetDir: string;
@@ -559,4 +611,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };
+export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeVa
 export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.js';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.2.1";
+declare const CAATINGA_CORE_VERSION = "2.3.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -85,6 +85,38 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         bindingsOutput: string;
         framework?: "vite-react" | "next" | "astro" | undefined;
     }>;
+    zk: z.ZodOptional<z.ZodObject<{
+        circuits: z.ZodRecord<z.ZodString, z.ZodObject<{
+            path: z.ZodString;
+            protocol: z.ZodLiteral<"groth16">;
+            curve: z.ZodLiteral<"bls12381">;
+            verifierContract: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    }, {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     project: string;
     defaultNetwork: string;
@@ -102,6 +134,14 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         framework: "vite-react" | "next" | "astro";
         bindingsOutput: string;
     };
+    zk?: {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    } | undefined;
 }, {
     project: string;
     contracts: Record<string, {
@@ -119,6 +159,14 @@ declare const CaatingaConfigSchema: z.ZodObject<{
         framework?: "vite-react" | "next" | "astro" | undefined;
     };
     defaultNetwork?: string | undefined;
+    zk?: {
+        circuits: Record<string, {
+            path: string;
+            protocol: "groth16";
+            curve: "bls12381";
+            verifierContract?: string | undefined;
+        }>;
+    } | undefined;
 }>;
 type CaatingaConfig = z.infer<typeof CaatingaConfigSchema>;
 type ContractConfig = z.infer<typeof ContractConfigSchema>;
@@ -232,6 +280,7 @@ type RunCommandResult = {
 type RunCommandOptions = {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
+    input?: string;
     skipStellarVersionCheck?: boolean;
     failureCode?: CaatingaErrorCodeValue;
 };
@@ -286,6 +335,8 @@ type ResolvedContract = {
 };
 declare function resolveContract(config: CaatingaConfig, contractName: string, cwd?: string): ResolvedContract;
 
+declare function resolveDefaultContractName(config: CaatingaConfig): string;
+
 type BuildContractOptions = {
     config: CaatingaConfig;
     contractName: string;
@@ -444,6 +495,7 @@ type CreateProjectFromTemplateOptions = {
     projectName: string;
     targetDir: string;
     templateDir: string;
+    filter?: (relativePath: string) => boolean;
 };
 declare function createProjectFromTemplate(options: CreateProjectFromTemplateOptions): Promise<{
     targetDir: string;
@@ -559,4 +611,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };
+export { BINDING_MARKER_FILENAME, type BindingFreshness, type BindingFreshnessStatus, type BindingMarker, BindingMarkerSchema, type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CollectProjectStatusOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type ContractStatusEntry, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateBindingFreshnessOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type NetworkStatus, type ProjectStatus, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, collectProjectStatus, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateBindingFreshness, evaluateBindingsFreshness, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, readBindingMarker, resolveContract, resolveDefaultContractName, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts, writeBindingMarker };

package/dist/index.js

@@ -105,7 +105,7 @@ function formatCause(cause) {
 }
 
 // src/version.ts
-var CAATINGA_CORE_VERSION = "2.2.1";
+var CAATINGA_CORE_VERSION = "2.3.0";
 
 // src/config/config.schema.ts
 import { z } from "zod";
@@ -120,6 +120,15 @@ var NetworkConfigSchema = z.object({
   rpcUrl: z.string().url(),
   networkPassphrase: z.string().min(1)
 });
+var ZkCircuitSchema = z.object({
+  path: z.string().min(1),
+  protocol: z.literal("groth16"),
+  curve: z.literal("bls12381"),
+  verifierContract: z.string().optional()
+});
+var ZkConfigSchema = z.object({
+  circuits: z.record(z.string().min(1), ZkCircuitSchema)
+}).optional();
 var CaatingaConfigSchema = z.object({
   project: z.string().min(1),
   defaultNetwork: z.string().min(1).default("testnet"),
@@ -134,7 +143,8 @@ var CaatingaConfigSchema = z.object({
   frontend: z.object({
     framework: z.enum(["vite-react", "next", "astro"]).default("vite-react"),
     bindingsOutput: z.string().min(1)
-  })
+  }),
+  zk: ZkConfigSchema
 });
 
 // src/config/define-config.ts
@@ -577,6 +587,7 @@ async function runCommand(command, args, options = {}) {
     const result = await execa(command, args, {
       cwd: options.cwd,
       env: options.env,
+      input: options.input,
       all: true,
       reject: true
     });
@@ -791,6 +802,19 @@ function resolveContract(config, contractName, cwd = process.cwd()) {
   };
 }
 
+// src/contracts/resolve-default-contract.ts
+function resolveDefaultContractName(config) {
+  const names = Object.keys(config.contracts);
+  if (names.length === 1) {
+    return names[0];
+  }
+  throw new CaatingaError(
+    "Pass a contract name to build.",
+    CaatingaErrorCode.CONTRACT_NOT_FOUND,
+    `Configured contracts: ${names.join(", ")}. Example: caatinga build ${names[0]}`
+  );
+}
+
 // src/contracts/wasm.ts
 import { createHash } from "crypto";
 import { access as access2, readdir as readdir2, readFile as readFile3, stat } from "fs/promises";
@@ -1581,15 +1605,18 @@ async function createProjectFromTemplate(options) {
     );
   }
   const manifest = await readTemplateManifest(templateDir);
+  const mergeIntoExisting = Boolean(options.filter);
   await mkdir3(targetDir, { recursive: true });
   await cp(templateDir, targetDir, {
     recursive: true,
-    force: false,
-    errorOnExist: true,
-    filter: (source) => shouldCopyTemplateEntry(templateDir, source)
+    force: mergeIntoExisting,
+    errorOnExist: !mergeIntoExisting,
+    filter: (source) => shouldCopyTemplateEntry(templateDir, source, options.filter)
   });
   await replaceTemplateVariables(targetDir, options.projectName);
-  await ensureArtifacts(targetDir, options.projectName);
+  if (!mergeIntoExisting) {
+    await ensureArtifacts(targetDir, options.projectName);
+  }
   return { targetDir, template: manifest };
 }
 async function ensureArtifacts(targetDir, projectName) {
@@ -1655,11 +1682,15 @@ async function replaceTemplateVariables(dir, projectName) {
     await writeFile3(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
   }));
 }
-function shouldCopyTemplateEntry(templateDir, source) {
+function shouldCopyTemplateEntry(templateDir, source, userFilter) {
   const relativePath = path10.relative(templateDir, source);
   if (!relativePath || relativePath === ".") {
     return true;
   }
+  const normalizedPath = relativePath.split(path10.sep).join("/");
+  if (userFilter && !userFilter(normalizedPath)) {
+    return false;
+  }
   return !relativePath.split(path10.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
 }
 function isTextTemplateFile(filePath) {
@@ -1732,6 +1763,7 @@ export {
   readArtifacts,
   readBindingMarker,
   resolveContract,
+  resolveDefaultContractName,
   resolveDeployArgs,
   resolveDeployOrder,
   resolveNetwork,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/core",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "Core config, artifacts, command orchestration, and error primitives for Caatinga/Soroban toolkit",
   "keywords": [
     "stellar",