@ton/blueprint 0.31.0 → 0.32.0

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.32.0] - 2025-05-02
+
+### Added
+
+- Compiler version is now shown during contract build
+- Added 'All Contracts' option to build wizard
+- Added function to build all tact contracts, required for rebuilding before tests
+
+### Changed
+
+- Made error of non-PascalCase contract names nicer
+
+### Fixed
+
+- `blueprint build --all` now exits with a non-zero exit code on failure
+
+## [0.31.1] - 2025-04-24
+
+### Fixed
+
+- Fixed build directory creation
+
 ## [0.31.0] - 2025-04-24
 
 ### Added

package/README.md

@@ -122,6 +122,10 @@ export async function run(provider: NetworkProvider) {
 
 FunC version can be updated using `npx/yarn blueprint set func` command
 
+### Updating Tact version
+
+Tact version can be updated to the latest using `npm update/yarn upgrade @tact-lang/compiler` command
+
 ### Help and additional commands
 
 Run in terminal:   `npx blueprint help`   or   `yarn blueprint help`

package/dist/build.d.ts

@@ -1,3 +1,4 @@
 import { UIProvider } from './ui/UIProvider';
 export declare function buildOne(contract: string, ui?: UIProvider): Promise<void>;
 export declare function buildAll(ui?: UIProvider): Promise<void>;
+export declare function buildAllTact(ui?: UIProvider): Promise<void>;

package/dist/build.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildAll = exports.buildOne = void 0;
+exports.buildAllTact = exports.buildAll = exports.buildOne = void 0;
 const path_1 = __importDefault(require("path"));
 const promises_1 = __importDefault(require("fs/promises"));
 const compile_1 = require("./compile/compile");
@@ -18,6 +18,9 @@ async function buildOne(contract, ui) {
     catch (e) { }
     ui?.setActionPrompt('⏳ Compiling...');
     try {
+        const config = await (0, compile_1.getCompilerConfigForContract)(contract);
+        const compilerOptions = await (0, compile_1.getCompilerOptions)(config);
+        ui?.write(`🔧 Using ${compilerOptions.lang} version ${compilerOptions.version}...`);
         const result = await (0, compile_1.doCompile)(contract);
         if (result.lang === 'tact') {
             for (const [k, v] of result.fs) {
@@ -48,7 +51,7 @@ async function buildOne(contract, ui) {
         await promises_1.default.writeFile(buildArtifactPath, JSON.stringify(res));
         if (result.lang === 'func' || result.lang === 'tolk') {
             const fiftFilepath = path_1.default.join(paths_1.BUILD_DIR, contract, `${contract}.fif`);
-            await promises_1.default.mkdir(path_1.default.join(paths_1.BUILD_DIR, contract));
+            await promises_1.default.mkdir(path_1.default.join(paths_1.BUILD_DIR, contract), { recursive: true });
             await promises_1.default.writeFile(fiftFilepath, result.fiftCode);
         }
         ui?.write(`\n✅ Wrote compilation artifact to ${path_1.default.relative(process.cwd(), buildArtifactPath)}`);
@@ -71,3 +74,13 @@ async function buildAll(ui) {
     }
 }
 exports.buildAll = buildAll;
+async function buildAllTact(ui) {
+    // TODO: when tact config introduced rewrite to use it
+    for (const file of await (0, utils_1.findCompiles)()) {
+        const config = await (0, compile_1.extractCompileConfig)(file.path);
+        if (config.lang === 'tact') {
+            await buildOne(file.name, ui);
+        }
+    }
+}
+exports.buildAllTact = buildAllTact;

package/dist/cli/Runner.d.ts

@@ -3,6 +3,7 @@ import { UIProvider } from '../ui/UIProvider';
 import { Config } from '../config/Config';
 export declare const argSpec: {};
 export type Args = arg.Result<typeof argSpec>;
+export declare function extractFirstArg(args: Args): string | undefined;
 export type RunnerContext = {
     config?: Config;
 };

package/dist/cli/Runner.js

@@ -1,4 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.argSpec = void 0;
+exports.extractFirstArg = exports.argSpec = void 0;
 exports.argSpec = {};
+function extractFirstArg(args) {
+    return args._.length > 1 && args._[1].trim().length > 0 ? args._[1].trim() : undefined;
+}
+exports.extractFirstArg = extractFirstArg;

package/dist/cli/build.d.ts

@@ -1,8 +1,6 @@
 import { Args, Runner } from './Runner';
 import { UIProvider } from '../ui/UIProvider';
-export declare function selectCompile(ui: UIProvider, args: Args): Promise<{
-    module: any;
-    name: string;
-    path: string;
-}>;
+export declare function extractBuildFile(args: Args): string | undefined;
+export declare function selectContract(ui: UIProvider, hint?: string): Promise<string>;
+export declare function selectContract(ui: UIProvider, hint?: string, withAllOption?: boolean): Promise<string | string[]>;
 export declare const build: Runner;

package/dist/cli/build.js

@@ -3,19 +3,38 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.build = exports.selectCompile = void 0;
+exports.build = exports.selectContract = exports.extractBuildFile = void 0;
 const utils_1 = require("../utils");
 const arg_1 = __importDefault(require("arg"));
 const build_1 = require("../build");
 const constants_1 = require("./constants");
-async function selectCompile(ui, args) {
-    return await (0, utils_1.selectFile)(await (0, utils_1.findCompiles)(), {
+function extractBuildFile(args) {
+    return args._.length > 1 && args._[1].length > 0 ? args._[1] : undefined;
+}
+exports.extractBuildFile = extractBuildFile;
+async function selectContract(ui, hint, withAllOption = false) {
+    const compiles = await (0, utils_1.findCompiles)();
+    const contracts = compiles.map(compile => compile.name);
+    const options = contracts.map((contract) => ({ name: contract, value: contract }));
+    const allContractsValue = 'all_contracts';
+    if (withAllOption) {
+        const allContractsOption = {
+            name: 'All Contracts',
+            value: allContractsValue,
+        };
+        options.push(allContractsOption);
+    }
+    const selectedOption = await (0, utils_1.selectOption)(options, {
+        msg: 'Select contract to use',
         ui,
-        hint: args._.length > 1 && args._[1].length > 0 ? args._[1] : undefined,
-        import: false,
+        hint,
     });
+    if (selectedOption.value === allContractsValue) {
+        return contracts;
+    }
+    return selectedOption.value;
 }
-exports.selectCompile = selectCompile;
+exports.selectContract = selectContract;
 const build = async (args, ui) => {
     const localArgs = (0, arg_1.default)({
         '--all': Boolean,
@@ -26,11 +45,16 @@ const build = async (args, ui) => {
         return;
     }
     if (localArgs['--all']) {
-        await (0, build_1.buildAll)();
+        await (0, build_1.buildAll)(ui);
     }
     else {
-        const sel = await selectCompile(ui, localArgs);
-        await (0, build_1.buildOne)(sel.name, ui);
+        const selected = await selectContract(ui, extractBuildFile(args), true);
+        if (typeof selected === 'string') {
+            await (0, build_1.buildOne)(selected, ui);
+        }
+        else {
+            await (0, build_1.buildAll)(ui);
+        }
     }
 };
 exports.build = build;

package/dist/cli/create.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.create = void 0;
+const Runner_1 = require("./Runner");
 const promises_1 = require("fs/promises");
 const path_1 = __importDefault(require("path"));
 const template_1 = require("../template");
@@ -56,13 +57,16 @@ const create = async (args, ui) => {
         ui.write(constants_1.helpMessages['create']);
         return;
     }
-    const name = localArgs._.length > 1 && localArgs._[1].trim().length > 0
-        ? localArgs._[1].trim()
-        : await ui.input('Contract name (PascalCase)');
+    const name = (0, Runner_1.extractFirstArg)(localArgs)
+        ?? await ui.input('Contract name (PascalCase)');
     if (name.length === 0)
         throw new Error(`Cannot create a contract with an empty name`);
-    if (name.toLowerCase() === 'contract' || !/^[A-Z][a-zA-Z0-9]*$/.test(name))
-        throw new Error(`Cannot create a contract with the name '${name}'`);
+    if (name.toLowerCase() === 'contract') {
+        throw new Error(`Cannot create a contract with the reserved name 'contract'. Please choose a different name.`);
+    }
+    if (!(0, utils_1.isPascalCase)(name)) {
+        throw new Error(`Contract name '${name}' is not in PascalCase. Please try ${(0, utils_1.toPascalCase)(name)}.`);
+    }
     const which = (await (0, utils_1.selectOption)(constants_1.templateTypes, {
         ui,
         msg: 'What type of contract do you want to create?',

package/dist/cli/verify.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.verify = void 0;
 const core_1 = require("@ton/core");
 const compile_1 = require("../compile/compile");
+const Runner_1 = require("./Runner");
 const path_1 = __importDefault(require("path"));
 const createNetworkProvider_1 = require("../network/createNetworkProvider");
 const build_1 = require("./build");
@@ -126,7 +127,7 @@ const verify = async (args, ui, context) => {
         ui.write(constants_1.helpMessages['verify']);
         return;
     }
-    const sel = await (0, build_1.selectCompile)(ui, localArgs);
+    const selectedContract = await (0, build_1.selectContract)(ui, (0, Runner_1.extractFirstArg)(localArgs));
     const networkProvider = await (0, createNetworkProvider_1.createNetworkProvider)(ui, localArgs, context.config, false);
     const sender = networkProvider.sender();
     const senderAddress = sender.address;
@@ -137,7 +138,7 @@ const verify = async (args, ui, context) => {
     if (network === 'custom') {
         throw new Error('Cannot use custom network');
     }
-    const result = await (0, compile_1.doCompile)(sel.name);
+    const result = await (0, compile_1.doCompile)(selectedContract);
     const resHash = result.code.hash();
     ui.write(`Compiled code hash hex: ${resHash.toString('hex')}`);
     ui.write('We can look up the address with such code hash in the blockchain automatically');

package/dist/compile/compile.d.ts

@@ -1,8 +1,10 @@
 /// <reference types="node" />
 import { Cell } from '@ton/core';
-import { TactCompilerConfig } from './CompilerConfig';
+import { CompilerConfig, TactCompilerConfig } from './CompilerConfig';
 export declare function getCompilablesDirectory(): Promise<string>;
 export declare const COMPILE_END = ".compile.ts";
+export declare function extractCompileConfig(path: string): Promise<CompilerConfig>;
+export declare function getCompilerConfigForContract(name: string): Promise<CompilerConfig>;
 export type SourceSnapshot = {
     filename: string;
     content: string;
@@ -28,8 +30,14 @@ export type TactCompileResult = {
     fs: Map<string, Buffer>;
     code: Cell;
     options?: TactCompilerConfig['options'];
+    version: string;
 };
+export declare function getTactVersion(): Promise<any>;
 export type CompileResult = TactCompileResult | FuncCompileResult | TolkCompileResult;
+export declare function getCompilerOptions(config: CompilerConfig): Promise<{
+    lang: 'tact' | 'tolk' | 'func';
+    version: string;
+}>;
 export declare function doCompile(name: string, opts?: CompileOpts): Promise<CompileResult>;
 /**
  * Optional compilation settings, including user data passed to hooks

package/dist/compile/compile.js

@@ -25,8 +25,9 @@ var __importStar = (this && this.__importStar) || function (mod) {
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
+var _a, _b;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.compile = exports.doCompile = exports.COMPILE_END = exports.getCompilablesDirectory = void 0;
+exports.compile = exports.doCompile = exports.getCompilerOptions = exports.getTactVersion = exports.getCompilerConfigForContract = exports.extractCompileConfig = exports.COMPILE_END = exports.getCompilablesDirectory = void 0;
 const func_js_1 = require("@ton-community/func-js");
 const fs_1 = require("fs");
 const path_1 = __importDefault(require("path"));
@@ -45,15 +46,19 @@ async function getCompilablesDirectory() {
 }
 exports.getCompilablesDirectory = getCompilablesDirectory;
 exports.COMPILE_END = '.compile.ts';
-async function getCompilerConfigForContract(name) {
-    var _a;
-    const compilablesDirectory = await getCompilablesDirectory();
-    const mod = await (_a = path_1.default.join(compilablesDirectory, name + exports.COMPILE_END), Promise.resolve().then(() => __importStar(require(_a))));
+async function extractCompileConfig(path) {
+    const mod = await (_a = path, Promise.resolve().then(() => __importStar(require(_a))));
     if (typeof mod.compile !== 'object') {
         throw new Error(`Object 'compile' is missing`);
     }
     return mod.compile;
 }
+exports.extractCompileConfig = extractCompileConfig;
+async function getCompilerConfigForContract(name) {
+    const compilablesDirectory = await getCompilablesDirectory();
+    return extractCompileConfig(path_1.default.join(compilablesDirectory, name + exports.COMPILE_END));
+}
+exports.getCompilerConfigForContract = getCompilerConfigForContract;
 async function doCompileTolk(config) {
     const res = await (0, tolk_js_1.runTolkCompiler)(config);
     if (res.status === 'error') {
@@ -116,6 +121,12 @@ function getRootTactConfigOptionsForContract(name) {
     }
     return undefined;
 }
+async function getTactVersion() {
+    const packageJsonPath = require.resolve('@tact-lang/compiler/package.json');
+    const { version } = await (_b = packageJsonPath, Promise.resolve().then(() => __importStar(require(_b))));
+    return version;
+}
+exports.getTactVersion = getTactVersion;
 async function doCompileTact(config, name) {
     const rootConfigOptions = getRootTactConfigOptionsForContract(name);
     const fs = new OverwritableVirtualFileSystem_1.OverwritableVirtualFileSystem(process.cwd());
@@ -139,6 +150,7 @@ async function doCompileTact(config, name) {
         fs: fs.overwrites,
         code,
         options: buildConfig.config.options,
+        version: await getTactVersion(),
     };
 }
 async function doCompileInner(name, config) {
@@ -160,6 +172,25 @@ async function doCompileInner(name, config) {
         optLevel: config.optLevel,
     });
 }
+function getCompilerName(config) {
+    return config.lang ?? 'func';
+}
+async function getCompilerVersion(config) {
+    if (config.lang === 'tact') {
+        return getTactVersion();
+    }
+    if (config.lang === 'tolk') {
+        return (0, tolk_js_1.getTolkCompilerVersion)();
+    }
+    return (await (0, func_js_1.compilerVersion)()).funcVersion;
+}
+async function getCompilerOptions(config) {
+    return {
+        lang: getCompilerName(config),
+        version: await getCompilerVersion(config),
+    };
+}
+exports.getCompilerOptions = getCompilerOptions;
 async function doCompile(name, opts) {
     const config = await getCompilerConfigForContract(name);
     if (config.preCompileHook !== undefined) {

package/dist/index.d.ts

@@ -8,4 +8,4 @@ export { Config } from './config/Config';
 export { Args, Runner, RunnerContext } from './cli/Runner';
 export { PluginRunner, Plugin } from './config/Plugin';
 export { CustomNetwork } from './config/CustomNetwork';
-export { buildOne, buildAll } from './build';
+export { buildOne, buildAll, buildAllTact } from './build';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildAll = exports.buildOne = exports.compile = exports.createNetworkProvider = exports.sleep = exports.tonDeepLink = void 0;
+exports.buildAllTact = exports.buildAll = exports.buildOne = exports.compile = exports.createNetworkProvider = exports.sleep = exports.tonDeepLink = void 0;
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "tonDeepLink", { enumerable: true, get: function () { return utils_1.tonDeepLink; } });
 Object.defineProperty(exports, "sleep", { enumerable: true, get: function () { return utils_1.sleep; } });
@@ -11,3 +11,4 @@ Object.defineProperty(exports, "compile", { enumerable: true, get: function () {
 var build_1 = require("./build");
 Object.defineProperty(exports, "buildOne", { enumerable: true, get: function () { return build_1.buildOne; } });
 Object.defineProperty(exports, "buildAll", { enumerable: true, get: function () { return build_1.buildAll; } });
+Object.defineProperty(exports, "buildAllTact", { enumerable: true, get: function () { return build_1.buildAllTact; } });

package/dist/utils/index.d.ts

@@ -2,3 +2,4 @@ export * from './object.utils';
 export * from './timer.utils';
 export * from './ton.utils';
 export * from './selection.utils';
+export * from './string.utils';

package/dist/utils/index.js

@@ -18,3 +18,4 @@ __exportStar(require("./object.utils"), exports);
 __exportStar(require("./timer.utils"), exports);
 __exportStar(require("./ton.utils"), exports);
 __exportStar(require("./selection.utils"), exports);
+__exportStar(require("./string.utils"), exports);

package/dist/utils/string.utils.d.ts

@@ -0,0 +1,2 @@
+export declare function isPascalCase(str: string): boolean;
+export declare function toPascalCase(str: string): string;

package/dist/utils/string.utils.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toPascalCase = exports.isPascalCase = void 0;
+function isPascalCase(str) {
+    return /^[A-Z][a-zA-Z0-9]*$/.test(str);
+}
+exports.isPascalCase = isPascalCase;
+function toPascalCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1 $2') // Splits camelCase words into separate words
+        .replace(/[^a-zA-Z0-9]+/g, ' ') // Replaces all characters that are not allowed with spaces
+        .toLowerCase() // Converts the entire string to lowercase
+        .replace(/(?:^|\s)(\p{L})/gu, (_, letter) => letter.toUpperCase()) // Capitalizes the first letter of each word
+        .replace(/\s+/g, ''); // Removes all spaces
+}
+exports.toPascalCase = toPascalCase;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/blueprint",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "Framework for development of TON smart contracts",
   "main": "dist/index.js",
   "bin": "./dist/cli/cli.js",