dappbooster 3.1.5 → 3.3.0

package/dist/components/steps/PostInstall.d.ts

@@ -1,6 +1,8 @@
 import type { FC } from 'react';
+import { type Stack } from '../../constants/config.js';
 import type { InstallationType, MultiSelectItem } from '../../types/types.js';
 interface Props {
+    stack: Stack;
     installationConfig: {
         installationType: InstallationType | undefined;
         selectedFeatures?: Array<MultiSelectItem>;

package/dist/components/steps/PostInstall.js

@@ -2,14 +2,21 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import figures from 'figures';
 import { Box, Text } from 'ink';
 import Link from 'ink-link';
-import { isFeatureSelected } from '../../utils/utils.js';
+import { getStackConfig } from '../../constants/config.js';
+import { isFeatureSelected, resolveModeFeatures } from '../../utils/utils.js';
 import Divider from '../Divider.js';
 const SubgraphWarningMessage = () => (_jsxs(Box, { flexDirection: 'column', rowGap: 1, children: [_jsx(Box, { alignItems: 'center', borderColor: 'yellow', borderStyle: 'bold', flexDirection: 'column', justifyContent: 'center', padding: 1, children: _jsxs(Text, { color: 'yellow', children: [figures.warning, figures.warning, " ", _jsx(Text, { bold: true, children: "WARNING:" }), " You ", _jsx(Text, { bold: true, children: "MUST" }), " finish the subgraph's configuration manually ", figures.warning, figures.warning] }) }), _jsx(Text, { color: 'whiteBright', children: "Follow these steps:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Provide your own API key for ", _jsx(Text, { color: 'gray', children: "PUBLIC_SUBGRAPHS_API_KEY" }), " in", ' ', _jsx(Text, { color: 'gray', children: ".env.local" }), " You can get one", ' ', _jsx(Link, { url: "https://thegraph.com/studio/apikeys", children: "here" })] }), _jsxs(Text, { children: ["2- After the API key is correctly configured, run", ' ', _jsx(Text, { color: 'gray', children: "pnpm subgraph-codegen" }), " in your console from the project's folder"] })] }), _jsxs(Text, { children: ["More configuration info in", ' ', _jsx(Link, { url: 'https://docs.dappbooster.dev/introduction/getting-started', children: "the docs" }), "."] }), _jsxs(Text, { color: 'yellow', bold: true, children: [figures.info, " Only after you have followed the previous steps you may proceed."] })] }));
-const PostInstallMessage = ({ projectName }) => (_jsxs(Box, { flexDirection: 'column', rowGap: 1, paddingBottom: 2, children: [_jsx(Text, { color: 'whiteBright', children: "To start development on your project:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Move into the project's folder with ", _jsxs(Text, { color: 'gray', children: ["cd ", projectName] })] }), _jsxs(Text, { children: ["2- Start the development server with ", _jsx(Text, { color: 'gray', children: "pnpm dev" })] })] }), _jsx(Text, { color: 'whiteBright', children: "More info:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["- Check out ", _jsx(Text, { color: 'gray', children: ".env.local" }), " for more configurations."] }), _jsxs(Text, { children: ["- Read ", _jsx(Link, { url: "https://docs.dappbooster.dev", children: "the docs" }), " to know more about", ' ', _jsx(Text, { color: 'gray', children: "dAppBooster" }), "!"] }), _jsxs(Text, { children: ["- Report issues with this installer", ' ', _jsx(Link, { url: "https://github.com/BootNodeDev/dAppBoosterInstallScript/issues", children: "here" })] })] })] }));
-const PostInstall = ({ installationConfig, projectName }) => {
+const EvmPostInstallMessage = ({ projectName }) => (_jsxs(Box, { flexDirection: 'column', rowGap: 1, paddingBottom: 2, children: [_jsx(Text, { color: 'whiteBright', children: "To start development on your project:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Move into the project's folder with ", _jsxs(Text, { color: 'gray', children: ["cd ", projectName] })] }), _jsxs(Text, { children: ["2- Start the development server with ", _jsx(Text, { color: 'gray', children: "pnpm dev" })] })] }), _jsx(Text, { color: 'whiteBright', children: "More info:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["- Check out ", _jsx(Text, { color: 'gray', children: ".env.local" }), " for more configurations."] }), _jsxs(Text, { children: ["- Read ", _jsx(Link, { url: "https://docs.dappbooster.dev", children: "the docs" }), " to know more about", ' ', _jsx(Text, { color: 'gray', children: "dAppBooster" }), "!"] }), _jsxs(Text, { children: ["- Report issues with this installer", ' ', _jsx(Link, { url: "https://github.com/BootNodeDev/dAppBoosterInstallScript/issues", children: "here" })] })] })] }));
+const CantonPostInstallMessage = ({ projectName, features }) => {
+    const carpinchoEnabled = isFeatureSelected('carpincho', features);
+    return (_jsxs(Box, { flexDirection: 'column', rowGap: 1, paddingBottom: 2, children: [_jsx(Text, { color: 'whiteBright', children: "To start the Canton stack:" }), _jsxs(Box, { flexDirection: 'column', children: [_jsxs(Text, { children: ["1- Move into the project's folder with ", _jsxs(Text, { color: 'gray', children: ["cd ", projectName] })] }), _jsxs(Text, { children: ["2- Configure canton-barebones: ", _jsx(Text, { color: 'gray', children: "canton-barebones/.env" }), " was created from the example \u2014 review it."] }), _jsxs(Text, { children: ["3- Start the local Canton stack with ", _jsx(Text, { color: 'gray', children: "npm run canton:up" })] }), _jsxs(Text, { children: ["4- In a separate terminal, run the dapp frontend:", ' ', _jsx(Text, { color: 'gray', children: "npm run app:dev" })] })] }), carpinchoEnabled && (_jsx(Box, { alignItems: 'center', borderColor: 'yellow', borderStyle: 'bold', flexDirection: 'column', justifyContent: 'center', padding: 1, children: _jsxs(Text, { color: 'yellow', children: [figures.info, " ", _jsx(Text, { bold: true, children: "Carpincho Wallet" }), ": build it with", ' ', _jsx(Text, { color: 'gray', children: "npm run carpincho:build:extension" }), " and load", ' ', _jsx(Text, { color: 'gray', children: "carpincho-wallet/dist-extension" }), " as an unpacked browser extension ", figures.info] }) })), _jsx(Text, { children: "See the Canton stack README inside the project for full instructions." })] }));
+};
+const PostInstall = ({ stack, installationConfig, projectName }) => {
     const { selectedFeatures, installationType } = installationConfig;
-    const features = selectedFeatures?.map((f) => f.value) ?? [];
-    const subgraphSupport = isFeatureSelected('subgraph', features);
-    return (_jsxs(_Fragment, { children: [_jsx(Divider, { title: 'Post-install instructions' }), _jsxs(Box, { flexDirection: 'column', rowGap: 2, children: [(subgraphSupport || installationType === 'full') && _jsx(SubgraphWarningMessage, {}), _jsx(PostInstallMessage, { projectName: projectName })] })] }));
+    const selectedNames = selectedFeatures?.map((f) => f.value) ?? [];
+    const features = resolveModeFeatures(stack, installationType ?? 'full', selectedNames);
+    const stackLabel = getStackConfig(stack).label;
+    return (_jsxs(_Fragment, { children: [_jsx(Divider, { title: `Post-install instructions — ${stackLabel}` }), _jsxs(Box, { flexDirection: 'column', rowGap: 2, children: [stack === 'evm' &&
+                        (isFeatureSelected('subgraph', features) || installationType === 'full') && (_jsx(SubgraphWarningMessage, {})), stack === 'evm' && _jsx(EvmPostInstallMessage, { projectName: projectName }), stack === 'canton' && (_jsx(CantonPostInstallMessage, { projectName: projectName, features: features }))] })] }));
 };
 export default PostInstall;

package/dist/components/steps/ProjectName.d.ts

@@ -2,13 +2,6 @@ import { type FC } from 'react';
 interface Props {
     onCompletion: () => void;
     onSubmit: (value: string) => void;
-    projectName: string;
 }
-/**
- * Component to ask for the project name.
- * @param projectName
- * @param onSubmit
- * @param onCompletion
- */
 declare const ProjectName: FC<Props>;
 export default ProjectName;

package/dist/components/steps/ProjectName.js

@@ -1,26 +1,52 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useCallback, useMemo } from 'react';
-import { isValidName } from '../../utils/utils.js';
+import { useCallback, useMemo, useState } from 'react';
+import { isValidName, projectDirectoryExists } from '../../utils/utils.js';
 import Ask from '../Ask.js';
-/**
- * Component to ask for the project name.
- * @param projectName
- * @param onSubmit
- * @param onCompletion
- */
-const ProjectName = ({ projectName, onSubmit, onCompletion }) => {
+const initialValidation = {
+    status: 'idle',
+    value: '',
+    error: '',
+};
+const ProjectName = ({ onSubmit, onCompletion }) => {
+    const [validation, setValidation] = useState(initialValidation);
     const validateName = useCallback((name) => {
-        if (name.length > 0 && !isValidName(name))
-            return 'Not a valid name!';
-        return '';
+        if (name.length === 0) {
+            return {
+                status: 'idle',
+                value: '',
+                error: '',
+            };
+        }
+        if (!isValidName(name)) {
+            return {
+                status: 'invalid',
+                value: name,
+                error: 'Not a valid name!',
+            };
+        }
+        if (projectDirectoryExists(name)) {
+            return {
+                status: 'invalid',
+                value: name,
+                error: `A directory named "${name}" already exists. Choose another name.`,
+            };
+        }
+        return {
+            status: 'valid',
+            value: name,
+            error: '',
+        };
     }, []);
-    const errorMessage = useMemo(() => validateName(projectName), [projectName, validateName]);
+    const errorMessage = useMemo(() => (validation.status === 'invalid' ? validation.error : ''), [validation.error, validation.status]);
+    const confirmedName = useMemo(() => (validation.status === 'valid' ? validation.value : undefined), [validation.status, validation.value]);
     const handleSubmit = useCallback((name) => {
-        onSubmit(name);
-        if (isValidName(name)) {
+        const nextValidation = validateName(name);
+        setValidation(nextValidation);
+        if (nextValidation.status === 'valid') {
+            onSubmit(nextValidation.value);
             onCompletion();
         }
-    }, [onSubmit, onCompletion]);
-    return (_jsx(Ask, { answer: projectName, errorMessage: errorMessage, onSubmit: handleSubmit, question: 'Project name', tip: 'Letters (a–z, A–Z), numbers (0–9), and underscores (_) are allowed.' }));
+    }, [onSubmit, onCompletion, validateName]);
+    return (_jsx(Ask, { answer: confirmedName, errorMessage: errorMessage, onSubmit: handleSubmit, question: 'Project name', tip: 'Letters (a-z, A-Z), numbers (0-9), and underscores (_) are allowed.' }));
 };
 export default ProjectName;

package/dist/components/steps/StackSelection.d.ts

@@ -0,0 +1,8 @@
+import { type FC } from 'react';
+import { type Stack } from '../../constants/config.js';
+interface Props {
+    onCompletion: () => void;
+    onSelect: (stack: Stack) => void;
+}
+declare const StackSelection: FC<Props>;
+export default StackSelection;

package/dist/components/steps/StackSelection.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import figures from 'figures';
+import { Text } from 'ink';
+import SelectInput from 'ink-select-input';
+import { useState } from 'react';
+import { stackDefinitions, stackNames } from '../../constants/config.js';
+import Divider from '../Divider.js';
+const stackItems = stackNames.map((name) => ({
+    label: `${stackDefinitions[name].label} — ${stackDefinitions[name].description}`,
+    value: name,
+}));
+const StackSelection = ({ onCompletion, onSelect }) => {
+    const [selectedStack, setSelectedStack] = useState();
+    const handleSelect = (item) => {
+        onSelect(item.value);
+        setSelectedStack(item.value);
+        onCompletion();
+    };
+    return (_jsxs(_Fragment, { children: [_jsx(Divider, { title: 'Select stack' }), selectedStack ? (_jsxs(Text, { children: ["Stack:", ' ', _jsx(Text, { bold: true, color: 'green', children: stackDefinitions[selectedStack].label })] })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: 'whiteBright', children: "Which stack do you want to scaffold?" }), _jsx(SelectInput, { indicatorComponent: ({ isSelected }) => (_jsx(Text, { color: "green", children: isSelected ? `${figures.pointer} ` : '  ' })), itemComponent: ({ label, isSelected }) => (_jsx(Text, { color: isSelected ? 'green' : 'white', bold: isSelected, children: label })), items: stackItems, onSelect: handleSelect })] }))] }));
+};
+export default StackSelection;

package/dist/constants/config.d.ts

@@ -1,11 +1,39 @@
-export declare const repoUrl = "https://github.com/BootNodeDev/dAppBooster.git";
-export type FeatureName = 'demo' | 'subgraph' | 'typedoc' | 'vocs' | 'husky';
+import type { InstallationType } from '../types/types.js';
+export type Stack = 'evm' | 'canton';
+export type RefType = 'tag-latest' | 'branch';
+export type PackageManager = 'pnpm' | 'npm';
+export type FeatureName = string;
 export type FeatureDefinition = {
     description: string;
     label: string;
     packages: string[];
     default: boolean;
     postInstall?: string[];
+    paths?: string[];
+    requires?: FeatureName[];
 };
-export declare const featureDefinitions: Record<FeatureName, FeatureDefinition>;
-export declare const featureNames: FeatureName[];
+export type EnvFile = {
+    from: string;
+    to: string;
+    ifFeature?: FeatureName;
+};
+export type StackConfig = {
+    label: string;
+    description: string;
+    repoUrl: string;
+    refType: RefType;
+    ref?: string;
+    packageManager: PackageManager;
+    removeAfterClone: string[];
+    postInstall?: string[];
+    envFiles: EnvFile[];
+    features: Record<FeatureName, FeatureDefinition>;
+};
+export declare const stackDefinitions: Record<Stack, StackConfig>;
+export declare const stackNames: Stack[];
+export declare function getStackConfig(stack: Stack): StackConfig;
+export declare function getFeatureNames(stack: Stack): FeatureName[];
+export declare function isFeatureNameValid(stack: Stack, name: string): boolean;
+export declare function isStackName(name: string): name is Stack;
+export declare function getDefaultFeatureNames(stack: Stack): FeatureName[];
+export declare function getInstallationModes(stack: Stack): InstallationType[];

package/dist/constants/config.js

@@ -1,50 +1,162 @@
-export const repoUrl = 'https://github.com/BootNodeDev/dAppBooster.git';
-export const featureDefinitions = {
-    demo: {
-        description: 'Component demos and example pages',
-        label: 'Component Demos',
-        packages: [],
-        default: true,
+import process from 'node:process';
+export const stackDefinitions = {
+    evm: {
+        label: 'EVM',
+        description: 'dAppBooster for EVM chains (Ethereum, Polygon, Base, …)',
+        repoUrl: 'https://github.com/BootNodeDev/dAppBooster.git',
+        refType: 'tag-latest',
+        packageManager: 'pnpm',
+        removeAfterClone: [],
+        envFiles: [{ from: '.env.example', to: '.env.local' }],
+        features: {
+            demo: {
+                description: 'Component demos and example pages',
+                label: 'Component Demos',
+                packages: [],
+                default: true,
+            },
+            subgraph: {
+                description: 'TheGraph subgraph integration',
+                label: 'Subgraph support',
+                packages: [
+                    '@bootnodedev/db-subgraph',
+                    'graphql',
+                    'graphql-request',
+                    '@graphql-codegen/cli',
+                    '@graphql-typed-document-node/core',
+                ],
+                default: true,
+                postInstall: [
+                    'Provide your own API key for PUBLIC_SUBGRAPHS_API_KEY in .env.local',
+                    'Run pnpm subgraph-codegen from the project folder',
+                ],
+            },
+            typedoc: {
+                description: 'TypeDoc API documentation generation',
+                label: 'Typedoc documentation support',
+                packages: [
+                    'typedoc',
+                    'typedoc-github-theme',
+                    'typedoc-plugin-inline-sources',
+                    'typedoc-plugin-missing-exports',
+                    'typedoc-plugin-rename-defaults',
+                ],
+                default: true,
+            },
+            vocs: {
+                description: 'Vocs documentation site',
+                label: 'Vocs documentation support',
+                packages: ['vocs'],
+                default: true,
+            },
+            husky: {
+                description: 'Git hooks with Husky, lint-staged, and commitlint',
+                label: 'Husky Git hooks support',
+                packages: ['husky', 'lint-staged', '@commitlint/cli', '@commitlint/config-conventional'],
+                default: true,
+            },
+        },
     },
-    subgraph: {
-        description: 'TheGraph subgraph integration',
-        label: 'Subgraph support',
-        packages: [
-            '@bootnodedev/db-subgraph',
-            'graphql',
-            'graphql-request',
-            '@graphql-codegen/cli',
-            '@graphql-typed-document-node/core',
-        ],
-        default: true,
+    canton: {
+        label: 'Canton',
+        description: 'dAppBooster for Canton (Daml ledger, Carpincho wallet, off-chain services)',
+        repoUrl: 'https://github.com/BootNodeDev/cn-dappbooster.git',
+        refType: 'branch',
+        ref: 'main',
+        packageManager: 'npm',
+        removeAfterClone: [],
         postInstall: [
-            'Provide your own API key for PUBLIC_SUBGRAPHS_API_KEY in .env.local',
-            'Run pnpm subgraph-codegen from the project folder',
+            'Review canton-barebones/.env (created from the example)',
+            'Run npm run canton:up to start the local Canton stack',
+            'Run npm run app:dev to start the dapp frontend',
         ],
-    },
-    typedoc: {
-        description: 'TypeDoc API documentation generation',
-        label: 'Typedoc documentation support',
-        packages: [
-            'typedoc',
-            'typedoc-github-theme',
-            'typedoc-plugin-inline-sources',
-            'typedoc-plugin-missing-exports',
-            'typedoc-plugin-rename-defaults',
+        envFiles: [
+            { from: 'canton-barebones/.env.example', to: 'canton-barebones/.env' },
+            { from: 'dapp/frontend/.env.local.example', to: 'dapp/frontend/.env.local' },
+            {
+                from: 'carpincho-wallet/.env.local.example',
+                to: 'carpincho-wallet/.env.local',
+                ifFeature: 'carpincho',
+            },
         ],
-        default: true,
-    },
-    vocs: {
-        description: 'Vocs documentation site',
-        label: 'Vocs documentation support',
-        packages: ['vocs'],
-        default: true,
-    },
-    husky: {
-        description: 'Git hooks with Husky, lint-staged, and commitlint',
-        label: 'Husky Git hooks support',
-        packages: ['husky', 'lint-staged', '@commitlint/cli', '@commitlint/config-conventional'],
-        default: true,
+        features: {
+            github: {
+                description: 'GitHub issue/PR templates and workflows (.github)',
+                label: 'GitHub templates & workflows',
+                packages: [],
+                default: false,
+                paths: ['.github'],
+            },
+            precommit: {
+                description: 'Pre-commit hooks (Husky, lint-staged, commitlint)',
+                label: 'Pre-commit hooks',
+                packages: [],
+                default: false,
+                paths: ['.husky', '.lintstagedrc.mjs', 'commitlint.config.js'],
+            },
+            carpincho: {
+                description: 'Carpincho browser-extension wallet (frontend + build tooling)',
+                label: 'Carpincho wallet',
+                packages: [],
+                default: true,
+                paths: ['carpincho-wallet'],
+                postInstall: [
+                    'Build the Carpincho extension with npm run carpincho:build:extension',
+                    'Load carpincho-wallet/dist-extension as an unpacked browser extension',
+                ],
+            },
+            llm: {
+                description: 'LLM and agent artifacts (.claude, AGENTS.md, CLAUDE.md, architecture.md, …)',
+                label: 'LLM & agent artifacts',
+                packages: [],
+                default: true,
+                paths: [
+                    '.claude',
+                    'AGENTS.md',
+                    'CLAUDE.md',
+                    'architecture.md',
+                    '.llm',
+                    '.llms',
+                    'llm',
+                    'llms',
+                    'llms.txt',
+                    'docs/llm',
+                    'docs/llms',
+                ],
+            },
+        },
     },
 };
-export const featureNames = Object.keys(featureDefinitions);
+export const stackNames = Object.keys(stackDefinitions);
+function envOverride(stack, suffix) {
+    const key = `DAPPBOOSTER_${stack.toUpperCase()}_${suffix}`;
+    const value = process.env[key];
+    return value && value.length > 0 ? value : undefined;
+}
+export function getStackConfig(stack) {
+    const base = stackDefinitions[stack];
+    const repoUrl = envOverride(stack, 'REPO_URL') ?? base.repoUrl;
+    const ref = envOverride(stack, 'REF') ?? base.ref;
+    return { ...base, repoUrl, ref };
+}
+export function getFeatureNames(stack) {
+    return Object.keys(stackDefinitions[stack].features);
+}
+export function isFeatureNameValid(stack, name) {
+    return name in stackDefinitions[stack].features;
+}
+export function isStackName(name) {
+    return stackNames.includes(name);
+}
+export function getDefaultFeatureNames(stack) {
+    return Object.entries(stackDefinitions[stack].features)
+        .filter(([, definition]) => definition.default)
+        .map(([name]) => name);
+}
+// Available installation modes per stack. `default` (keep only default:true features) is offered
+// only when the stack has at least one opt-out (default:false) feature; otherwise it would be
+// identical to `full`. Today that means Canton only (EVM's features are all default:true).
+export function getInstallationModes(stack) {
+    const hasOptOutFeature = getDefaultFeatureNames(stack).length < getFeatureNames(stack).length;
+    return hasOptOutFeature ? ['default', 'full', 'custom'] : ['full', 'custom'];
+}

package/dist/info.d.ts

@@ -1 +1,4 @@
-export declare function getInfoOutput(): string;
+export declare class InvalidStackFilterError extends Error {
+    constructor(filter: string);
+}
+export declare function getInfoOutput(stackFilter?: string): string;

package/dist/info.js

@@ -1,17 +1,43 @@
-import { featureDefinitions } from './constants/config.js';
-export function getInfoOutput() {
-    const features = Object.fromEntries(Object.entries(featureDefinitions).map(([name, def]) => [
-        name,
-        {
-            description: def.description,
-            default: def.default,
-            ...(def.postInstall ? { postInstall: def.postInstall } : {}),
-        },
-    ]));
+import { stackDefinitions, stackNames } from './constants/config.js';
+function buildStackInfo(stack) {
+    const config = stackDefinitions[stack];
+    return {
+        label: config.label,
+        description: config.description,
+        packageManager: config.packageManager,
+        features: Object.fromEntries(Object.entries(config.features).map(([name, def]) => [
+            name,
+            {
+                description: def.description,
+                default: def.default,
+                ...(def.postInstall ? { postInstall: def.postInstall } : {}),
+                ...(def.requires ? { requires: def.requires } : {}),
+            },
+        ])),
+    };
+}
+export class InvalidStackFilterError extends Error {
+    constructor(filter) {
+        super(`Unknown stack '${filter}'. Valid stacks: ${stackNames.join(', ')}`);
+        this.name = 'InvalidStackFilterError';
+    }
+}
+export function getInfoOutput(stackFilter) {
+    if (stackFilter !== undefined && !stackNames.includes(stackFilter)) {
+        throw new InvalidStackFilterError(stackFilter);
+    }
+    const stacks = {};
+    for (const name of stackNames) {
+        if (stackFilter !== undefined && stackFilter !== name) {
+            continue;
+        }
+        stacks[name] = buildStackInfo(name);
+    }
     return JSON.stringify({
-        features,
+        stacks,
         modes: {
             full: 'Install all features',
+            default: 'Install the recommended set (Canton only; for EVM this equals full)',
             custom: 'Choose features individually',
         },
     }, null, 2);

package/dist/nonInteractive.d.ts

@@ -1,4 +1,5 @@
 export declare function runNonInteractive(flags: {
+    stack?: string;
     name?: string;
     mode?: string;
     features?: string;

package/dist/nonInteractive.js

@@ -1,7 +1,8 @@
 import process from 'node:process';
-import { featureNames } from './constants/config.js';
+import { getFeatureNames, isFeatureNameValid, isStackName, stackNames, } from './constants/config.js';
 import { cleanupFiles, cloneRepo, createEnvFile, installPackages } from './operations/index.js';
-import { getPostInstallMessages, getProjectFolder, isValidName, projectDirectoryExists, } from './utils/utils.js';
+import { beginInstall, completeInstall } from './operations/installGuard.js';
+import { getPostInstallMessages, getProjectFolder, isValidName, projectDirectoryExists, resolveModeFeatures, } from './utils/utils.js';
 function fail(error) {
     const result = { success: false, error };
     console.log(JSON.stringify(result, null, 2));
@@ -25,6 +26,11 @@ function parseFeatures(featuresFlag) {
     });
 }
 function validate(flags) {
+    const stackFlag = flags.stack ?? 'evm';
+    if (!isStackName(stackFlag)) {
+        fail(`Invalid stack: '${stackFlag}'. Valid stacks: ${stackNames.join(', ')}`);
+    }
+    const stack = stackFlag;
     if (!flags.name) {
         fail('Missing required flag: --name');
     }
@@ -34,15 +40,22 @@ function validate(flags) {
     if (!isValidName(flags.name)) {
         fail('Invalid project name: only letters, numbers, and underscores are allowed');
     }
-    if (flags.mode !== 'full' && flags.mode !== 'custom') {
-        fail("Invalid mode: must be 'full' or 'custom'");
+    if (flags.mode !== 'full' && flags.mode !== 'default' && flags.mode !== 'custom') {
+        fail("Invalid mode: must be 'full', 'default', or 'custom'");
+    }
+    if (flags.mode === 'default' && stack === 'evm') {
+        fail("Invalid mode: 'default' is only available for the canton stack");
     }
-    // --mode=full ignores --features (everything is installed)
-    if (flags.mode === 'full') {
+    if (flags.mode === 'full' || flags.mode === 'default') {
         if (projectDirectoryExists(flags.name)) {
             fail(`Project directory '${flags.name}' already exists`);
         }
-        return { name: flags.name, mode: flags.mode, features: featureNames };
+        return {
+            stack,
+            name: flags.name,
+            mode: flags.mode,
+            features: resolveModeFeatures(stack, flags.mode),
+        };
     }
     if (!flags.features) {
         fail('--mode custom requires --features. Use --info to see available features.');
@@ -51,30 +64,40 @@ function validate(flags) {
     if (features.length === 0) {
         fail('--features value is empty. Use --info to see available features.');
     }
-    const invalidFeatures = features.filter((f) => !featureNames.includes(f));
+    const invalidFeatures = features.filter((f) => !isFeatureNameValid(stack, f));
     if (invalidFeatures.length > 0) {
-        fail(`Unknown features: ${invalidFeatures.join(', ')}. Valid features: ${featureNames.join(', ')}`);
+        const validNames = getFeatureNames(stack).join(', ');
+        fail(`Unknown features for stack '${stack}': ${invalidFeatures.join(', ')}. Valid features: ${validNames}`);
     }
     if (projectDirectoryExists(flags.name)) {
         fail(`Project directory '${flags.name}' already exists`);
     }
-    return { name: flags.name, mode: flags.mode, features };
+    return {
+        stack,
+        name: flags.name,
+        mode: flags.mode,
+        features: resolveModeFeatures(stack, 'custom', features),
+    };
 }
 export async function runNonInteractive(flags) {
-    const { name, mode, features } = validate(flags);
+    const { stack, name, mode, features } = validate(flags);
+    const projectFolder = getProjectFolder(name);
     try {
-        await cloneRepo(name);
-        const projectFolder = getProjectFolder(name);
-        await createEnvFile(projectFolder);
-        await installPackages(projectFolder, mode, features);
-        await cleanupFiles(projectFolder, mode, features);
+        // From here on a project directory exists on disk; an interrupt removes the partial scaffold.
+        beginInstall(projectFolder);
+        await cloneRepo(stack, name);
+        await createEnvFile(stack, projectFolder, features);
+        await installPackages(stack, projectFolder, mode, features);
+        await cleanupFiles(stack, projectFolder, mode, features);
+        completeInstall();
         const result = {
             success: true,
+            stack,
             projectName: name,
             mode,
             features,
             path: projectFolder,
-            postInstall: getPostInstallMessages(mode, features),
+            postInstall: getPostInstallMessages(stack, mode, features),
         };
         console.log(JSON.stringify(result, null, 2));
     }

package/dist/operations/cleanupFiles.d.ts

@@ -1,3 +1,3 @@
-import type { FeatureName } from '../constants/config.js';
+import { type FeatureName, type Stack } from '../constants/config.js';
 import type { InstallationType } from '../types/types.js';
-export declare function cleanupFiles(projectFolder: string, mode: InstallationType, features?: FeatureName[], onProgress?: (step: string) => void): Promise<void>;
+export declare function cleanupFiles(stack: Stack, projectFolder: string, mode: InstallationType, features?: FeatureName[], onProgress?: (step: string) => void): Promise<void>;