create-arui-scripts-app 1.0.0

package/bin/create-arui-scripts-app.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../build/cli.js');

package/build/build-context.d.ts

@@ -0,0 +1,2 @@
+import { type InitAnswers, type TemplateContext } from './types';
+export declare function buildContext(answers: InitAnswers, aruiScriptsVersion: string): TemplateContext;

package/build/build-context.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContext = buildContext;
+const VERSIONS = {
+    react: '^19.0.0',
+    reactDom: '^19.0.0',
+    typescript: '^6.0.0',
+    typesReact: '^19.0.0',
+    typesReactDom: '^19.0.0',
+    typesNode: '^24.0.0',
+    typesWebpackEnv: '^1.18.0',
+    hapi: '^21.3.2',
+    inert: '^7.1.0',
+    coreComponents: '^50.24.0',
+    coreComponentsConfig: '^1.1.0',
+    coreComponentsStackContext: '^1.0.1',
+    scriptsServer: '^1.3.1',
+    reduxToolkit: '^2.5.0',
+    reactRedux: '^9.2.0',
+    coreJs: '^3.32.0',
+    reactCompilerRuntime: '^1.0.0',
+    jest: '^29.7.0',
+    tsJest: '^29.1.0',
+    typesJest: '^29.5.0',
+    vitest: '^4.1.5',
+};
+function buildContext(answers, aruiScriptsVersion) {
+    const dependencies = {
+        react: VERSIONS.react,
+        'react-dom': VERSIONS.reactDom,
+        '@alfalab/core-components': VERSIONS.coreComponents,
+        '@alfalab/core-components-config': VERSIONS.coreComponentsConfig,
+        '@alfalab/core-components-stack-context': VERSIONS.coreComponentsStackContext,
+    };
+    const devDependencies = {
+        'arui-scripts': `^${aruiScriptsVersion}`,
+        typescript: VERSIONS.typescript,
+        '@types/react': VERSIONS.typesReact,
+        '@types/react-dom': VERSIONS.typesReactDom,
+        '@types/node': VERSIONS.typesNode,
+        '@types/webpack-env': VERSIONS.typesWebpackEnv,
+    };
+    if (!answers.clientOnly) {
+        dependencies['@alfalab/scripts-server'] = VERSIONS.scriptsServer;
+        dependencies['@hapi/hapi'] = VERSIONS.hapi;
+        dependencies['@hapi/inert'] = VERSIONS.inert;
+    }
+    if (answers.useRtk) {
+        dependencies['@reduxjs/toolkit'] = VERSIONS.reduxToolkit;
+        dependencies['react-redux'] = VERSIONS.reactRedux;
+    }
+    if (answers.polyfills) {
+        dependencies['core-js'] = VERSIONS.coreJs;
+    }
+    if (answers.reactCompiler) {
+        dependencies['react-compiler-runtime'] = VERSIONS.reactCompilerRuntime;
+    }
+    if (answers.testRunner === 'jest') {
+        devDependencies.jest = VERSIONS.jest;
+        devDependencies['ts-jest'] = VERSIONS.tsJest;
+        devDependencies['@types/jest'] = VERSIONS.typesJest;
+    }
+    else {
+        devDependencies.vitest = VERSIONS.vitest;
+    }
+    return {
+        name: answers.name,
+        useRtk: answers.useRtk,
+        clientOnly: answers.clientOnly,
+        codeLoader: answers.codeLoader,
+        testRunner: answers.testRunner,
+        cssModules: answers.cssModules,
+        clientServerPort: answers.clientServerPort,
+        serverPort: answers.serverPort,
+        dockerRegistry: answers.dockerRegistry.trim(),
+        presets: answers.presets.trim(),
+        polyfills: answers.polyfills,
+        reactCompiler: answers.reactCompiler,
+        aruiScriptsVersion,
+        dependencies,
+        devDependencies,
+    };
+}

package/build/build-file-map.d.ts

@@ -0,0 +1,3 @@
+import { type TemplateContext } from './types';
+export declare function clientBaseDir(ctx: TemplateContext): string;
+export declare function buildFileMap(ctx: TemplateContext): Record<string, string>;

package/build/build-file-map.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clientBaseDir = clientBaseDir;
+exports.buildFileMap = buildFileMap;
+const app_component_template_1 = require("./templates/app-component.template");
+const app_styles_template_1 = require("./templates/app-styles.template");
+const app_test_template_1 = require("./templates/app-test.template");
+const arui_scripts_config_template_1 = require("./templates/arui-scripts-config.template");
+const client_entry_template_1 = require("./templates/client-entry.template");
+const misc_template_1 = require("./templates/misc.template");
+const package_json_template_1 = require("./templates/package-json.template");
+const server_entry_template_1 = require("./templates/server-entry.template");
+const store_template_1 = require("./templates/store.template");
+const tsconfig_template_1 = require("./templates/tsconfig.template");
+const vitest_config_template_1 = require("./templates/vitest-config.template");
+function clientBaseDir(ctx) {
+    return ctx.clientOnly ? 'src' : 'src/client';
+}
+function buildFileMap(ctx) {
+    const client = clientBaseDir(ctx);
+    const files = {
+        'package.json': (0, package_json_template_1.packageJsonTemplate)(ctx),
+        'arui-scripts.config.ts': (0, arui_scripts_config_template_1.aruiScriptsConfigTemplate)(ctx),
+        'tsconfig.json': (0, tsconfig_template_1.tsconfigTemplate)(ctx),
+        '.gitignore': (0, misc_template_1.gitignoreTemplate)(),
+        '.yarnrc.yml': (0, misc_template_1.yarnrcTemplate)(),
+        'global-definitions.d.ts': (0, misc_template_1.globalDefinitionsTemplate)(),
+        'README.md': (0, misc_template_1.readmeTemplate)(ctx),
+        [`${client}/index.tsx`]: (0, client_entry_template_1.clientEntryTemplate)(ctx),
+        [`${client}/components/app.tsx`]: (0, app_component_template_1.appComponentTemplate)(ctx),
+        [`${client}/components/${(0, app_styles_template_1.appStylesFileName)(ctx)}`]: (0, app_styles_template_1.appStylesTemplate)(ctx),
+        [`${client}/components/__tests__/app.test.tsx`]: (0, app_test_template_1.appTestTemplate)(ctx),
+    };
+    if (!ctx.clientOnly) {
+        files['src/server/index.tsx'] = (0, server_entry_template_1.serverEntryTemplate)(ctx);
+    }
+    if (ctx.testRunner === 'vitest') {
+        files['vitest.config.ts'] = (0, vitest_config_template_1.vitestConfigTemplate)();
+    }
+    if (ctx.polyfills) {
+        files[`${client}/polyfills.ts`] = (0, misc_template_1.polyfillsTemplate)();
+    }
+    if (ctx.useRtk) {
+        files[`${client}/store/index.ts`] = (0, store_template_1.storeIndexTemplate)();
+        files[`${client}/store/hooks.ts`] = (0, store_template_1.storeHooksTemplate)();
+        files[`${client}/store/counter-slice.ts`] = (0, store_template_1.counterSliceTemplate)();
+    }
+    return files;
+}

package/build/cli.d.ts

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

package/build/cli.js

@@ -0,0 +1,15 @@
+"use strict";
+/* eslint-disable no-console */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const create_program_1 = require("./create-program");
+(0, create_program_1.createProgram)()
+    .parseAsync(process.argv)
+    .catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`${chalk_1.default.red('x')} ${message}`);
+    process.exit(1);
+});

package/build/create-program.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+import { type CliFlags } from './defaults';
+export type InitHandler = (dir: string | undefined, flags: CliFlags) => Promise<void>;
+export declare function createProgram(onInit?: InitHandler): Command;
+export declare function mapOptsToFlags(opts: Record<string, unknown>): CliFlags;

package/build/create-program.js

@@ -0,0 +1,103 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProgram = createProgram;
+exports.mapOptsToFlags = mapOptsToFlags;
+const commander_1 = require("commander");
+const run_1 = require("./run");
+// eslint-disable-next-line global-require, @typescript-eslint/no-var-requires
+const { version } = require('../package.json');
+const defaultInitHandler = (dir, flags) => (0, run_1.runInit)({ targetDirArg: dir, flags });
+function createProgram(onInit = defaultInitHandler) {
+    const program = new commander_1.Command('create-arui-scripts-app');
+    program
+        .description('Создает шаблонный проект arui-scripts')
+        .argument('[dir]', 'Директория проекта (по умолчанию - текущая)')
+        .version(version, '-v, --version', 'Показать версию')
+        .option('-y, --yes', 'Без вопросов, значения по умолчанию')
+        .option('--force', 'Перезаписать существующие файлы шаблона')
+        .option('--name <name>', 'Имя проекта (npm package name)')
+        .option('--rtk', 'React + Redux Toolkit')
+        .option('--no-rtk', 'Только React, без RTK')
+        .addOption(new commander_1.Option('--client-only', 'Только клиент').conflicts('ssr'))
+        .addOption(new commander_1.Option('--ssr', 'Клиент + сервер').conflicts('clientOnly'))
+        .addOption(new commander_1.Option('--code-loader <loader>', 'Транспилятор').choices(['swc', 'babel', 'tsc']))
+        .addOption(new commander_1.Option('--test-runner <runner>', 'Тест-раннер').choices(['jest', 'vitest']))
+        .option('--css-modules', 'CSS-модули')
+        .option('--no-css-modules', 'Обычный css')
+        .option('--client-port <port>', 'Порт dev-сервера', (value) => Number(value))
+        .option('--server-port <port>', 'Порт node-сервера', (value) => Number(value))
+        .option('--docker-registry <registry>', 'Docker registry')
+        .option('--presets <package>', 'Preset-пакет')
+        .option('--polyfills', 'Добавить core-js')
+        .option('--no-polyfills', 'Без полифилов')
+        .option('--react-compiler', 'Включить experimentalReactCompiler')
+        .option('--no-react-compiler', 'Выключить experimentalReactCompiler')
+        .option('--install', 'Установить зависимости после генерации')
+        .option('--no-install', 'Не устанавливать зависимости')
+        .showHelpAfterError('(используйте --help для справки)')
+        .action((dir, opts) => __awaiter(this, void 0, void 0, function* () {
+        yield onInit(dir, mapOptsToFlags(opts));
+    }));
+    return program;
+}
+function mapOptsToFlags(opts) {
+    const flags = {};
+    if (opts.yes === true) {
+        flags.yes = true;
+    }
+    if (opts.force === true) {
+        flags.force = true;
+    }
+    if (typeof opts.name === 'string') {
+        flags.name = opts.name;
+    }
+    if (typeof opts.rtk === 'boolean') {
+        flags.useRtk = opts.rtk;
+    }
+    if (opts.clientOnly === true) {
+        flags.clientOnly = true;
+    }
+    if (opts.ssr === true) {
+        flags.clientOnly = false;
+    }
+    if (typeof opts.codeLoader === 'string') {
+        flags.codeLoader = opts.codeLoader;
+    }
+    if (typeof opts.testRunner === 'string') {
+        flags.testRunner = opts.testRunner;
+    }
+    if (typeof opts.cssModules === 'boolean') {
+        flags.cssModules = opts.cssModules;
+    }
+    if (typeof opts.clientPort === 'number' && !Number.isNaN(opts.clientPort)) {
+        flags.clientServerPort = opts.clientPort;
+    }
+    if (typeof opts.serverPort === 'number' && !Number.isNaN(opts.serverPort)) {
+        flags.serverPort = opts.serverPort;
+    }
+    if (typeof opts.dockerRegistry === 'string') {
+        flags.dockerRegistry = opts.dockerRegistry;
+    }
+    if (typeof opts.presets === 'string') {
+        flags.presets = opts.presets;
+    }
+    if (typeof opts.polyfills === 'boolean') {
+        flags.polyfills = opts.polyfills;
+    }
+    if (typeof opts.reactCompiler === 'boolean') {
+        flags.reactCompiler = opts.reactCompiler;
+    }
+    if (typeof opts.install === 'boolean') {
+        flags.install = opts.install;
+    }
+    return flags;
+}

package/build/defaults.d.ts

@@ -0,0 +1,21 @@
+import { type CodeLoader, type InitAnswers, type TestRunner } from './types';
+export type CliFlags = {
+    yes?: boolean;
+    force?: boolean;
+    name?: string;
+    useRtk?: boolean;
+    clientOnly?: boolean;
+    codeLoader?: CodeLoader;
+    testRunner?: TestRunner;
+    cssModules?: boolean;
+    clientServerPort?: number;
+    serverPort?: number;
+    dockerRegistry?: string;
+    presets?: string;
+    polyfills?: boolean;
+    reactCompiler?: boolean;
+    install?: boolean;
+};
+export declare function defaultAnswers(name: string): InitAnswers;
+export declare function hasAnswerFlags(flags: CliFlags): boolean;
+export declare function answersFromFlags(defaultName: string, flags: CliFlags): InitAnswers;

package/build/defaults.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultAnswers = defaultAnswers;
+exports.hasAnswerFlags = hasAnswerFlags;
+exports.answersFromFlags = answersFromFlags;
+function defaultAnswers(name) {
+    return {
+        name,
+        useRtk: false,
+        clientOnly: false,
+        codeLoader: 'swc',
+        testRunner: 'jest',
+        cssModules: true,
+        clientServerPort: 8080,
+        serverPort: 3000,
+        dockerRegistry: '',
+        presets: '',
+        polyfills: false,
+        reactCompiler: false,
+        install: false,
+    };
+}
+const ANSWER_FLAG_KEYS = [
+    'name',
+    'useRtk',
+    'clientOnly',
+    'codeLoader',
+    'testRunner',
+    'cssModules',
+    'clientServerPort',
+    'serverPort',
+    'dockerRegistry',
+    'presets',
+    'polyfills',
+    'reactCompiler',
+    'install',
+];
+function hasAnswerFlags(flags) {
+    return ANSWER_FLAG_KEYS.some((key) => flags[key] !== undefined);
+}
+// cобираем все ответы из флагов CLI
+function answersFromFlags(defaultName, flags) {
+    var _a, _b;
+    const base = defaultAnswers(((_a = flags.name) === null || _a === void 0 ? void 0 : _a.trim()) || defaultName);
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({}, base), (flags.useRtk === undefined ? {} : { useRtk: flags.useRtk })), (flags.clientOnly === undefined ? {} : { clientOnly: flags.clientOnly })), (flags.codeLoader === undefined ? {} : { codeLoader: flags.codeLoader })), (flags.testRunner === undefined ? {} : { testRunner: flags.testRunner })), (flags.cssModules === undefined ? {} : { cssModules: flags.cssModules })), (flags.clientServerPort === undefined
+        ? {}
+        : { clientServerPort: flags.clientServerPort })), (flags.serverPort === undefined ? {} : { serverPort: flags.serverPort })), (flags.dockerRegistry === undefined ? {} : { dockerRegistry: flags.dockerRegistry })), (flags.presets === undefined ? {} : { presets: flags.presets })), (flags.polyfills === undefined ? {} : { polyfills: flags.polyfills })), (flags.reactCompiler === undefined ? {} : { reactCompiler: flags.reactCompiler })), (flags.install === undefined ? {} : { install: flags.install })), { name: (((_b = flags.name) === null || _b === void 0 ? void 0 : _b.trim()) || defaultName).trim() });
+}

package/build/install-dependencies.d.ts

@@ -0,0 +1,3 @@
+export type PackageManager = 'yarn' | 'npm';
+export declare function detectPackageManager(): PackageManager;
+export declare function installDependencies(targetDir: string, packageManager?: PackageManager): Promise<void>;

package/build/install-dependencies.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = detectPackageManager;
+exports.installDependencies = installDependencies;
+const child_process_1 = require("child_process");
+const shelljs_1 = __importDefault(require("shelljs"));
+function detectPackageManager() {
+    return shelljs_1.default.which('yarn') ? 'yarn' : 'npm';
+}
+function installDependencies(targetDir, packageManager = detectPackageManager()) {
+    const args = packageManager === 'yarn' ? [] : ['install'];
+    return new Promise((resolve, reject) => {
+        var _a, _b;
+        const child = (0, child_process_1.spawn)(packageManager, args, {
+            cwd: targetDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            // для windows
+            shell: process.platform === 'win32',
+        });
+        let output = '';
+        const collect = (chunk) => {
+            output += chunk.toString();
+        };
+        (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', collect);
+        (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on('data', collect);
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`${packageManager} ${args.join(' ')} завершился с кодом ${code}\n${output.trim()}`));
+            }
+        });
+    });
+}

package/build/questions.d.ts

@@ -0,0 +1,3 @@
+import type prompts from 'prompts';
+import { type CliFlags } from './defaults';
+export declare function getQuestions(defaultName: string, prefill?: CliFlags): prompts.PromptObject[];

package/build/questions.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getQuestions = getQuestions;
+const validate_project_name_1 = require("./validate-project-name");
+function getQuestions(defaultName, prefill = {}) {
+    const unlessAnswered = (key, type) => prefill[key] === undefined ? type : null;
+    return [
+        {
+            type: unlessAnswered('name', 'text'),
+            name: 'name',
+            message: 'Имя проекта',
+            initial: defaultName,
+            validate: (value) => (0, validate_project_name_1.validateProjectName)(value),
+        },
+        {
+            type: unlessAnswered('useRtk', 'select'),
+            name: 'useRtk',
+            message: 'Стек проекта',
+            initial: 0,
+            choices: [
+                { title: 'React', value: false, description: 'Только React и хуки' },
+                {
+                    title: 'React + RTK',
+                    value: true,
+                    description: 'Redux Toolkit для управления состоянием',
+                },
+            ],
+        },
+        {
+            type: unlessAnswered('clientOnly', 'select'),
+            name: 'clientOnly',
+            message: 'Тип приложения',
+            initial: 0,
+            choices: [
+                { title: 'SSR', value: false, description: 'Клиент + Node-сервер' },
+                { title: 'clientOnly', value: true, description: 'Статика, без сервера' },
+            ],
+        },
+        {
+            type: unlessAnswered('codeLoader', 'select'),
+            name: 'codeLoader',
+            message: 'Транспилятор кода',
+            initial: 0,
+            choices: [
+                { title: 'swc', value: 'swc', description: 'Самый быстрый' },
+                { title: 'babel', value: 'babel', description: 'Максимальная совместимость' },
+                { title: 'tsc', value: 'tsc', description: 'Через TypeScript-компилятор' },
+            ],
+        },
+        {
+            type: unlessAnswered('testRunner', 'select'),
+            name: 'testRunner',
+            message: 'На чем писать тесты',
+            initial: 0,
+            choices: [
+                { title: 'Jest', value: 'jest', description: 'Классика' },
+                { title: 'Vitest', value: 'vitest', description: 'Быстрее, на базе Vite' },
+            ],
+        },
+        {
+            type: unlessAnswered('cssModules', 'toggle'),
+            name: 'cssModules',
+            message: 'Использовать CSS-модули',
+            initial: true,
+            active: 'да',
+            inactive: 'нет',
+        },
+        {
+            type: unlessAnswered('clientServerPort', 'number'),
+            name: 'clientServerPort',
+            message: 'Порт dev-сервера (клиент)',
+            initial: 8080,
+        },
+        {
+            // Пропускаем порт сервера для clientOnly приложений
+            // и когда он уже задан флагом.
+            type: (_prev, values) => {
+                var _a;
+                const clientOnly = (_a = prefill.clientOnly) !== null && _a !== void 0 ? _a : values.clientOnly;
+                if (clientOnly || prefill.serverPort !== undefined) {
+                    return null;
+                }
+                return 'number';
+            },
+            name: 'serverPort',
+            message: 'Порт node-сервера',
+            initial: 3000,
+        },
+        {
+            type: unlessAnswered('dockerRegistry', 'text'),
+            name: 'dockerRegistry',
+            message: 'Docker registry (Enter - пропустить)',
+            initial: '',
+        },
+        {
+            type: unlessAnswered('presets', 'text'),
+            name: 'presets',
+            message: 'Preset-пакет (Enter - пропустить)',
+            initial: '',
+        },
+        {
+            type: unlessAnswered('polyfills', 'toggle'),
+            name: 'polyfills',
+            message: 'Добавить полифилы (core-js)',
+            initial: false,
+            active: 'да',
+            inactive: 'нет',
+        },
+        {
+            type: unlessAnswered('reactCompiler', 'toggle'),
+            name: 'reactCompiler',
+            message: 'Включить experimentalReactCompiler',
+            initial: false,
+            active: 'да',
+            inactive: 'нет',
+        },
+        {
+            type: unlessAnswered('install', 'toggle'),
+            name: 'install',
+            message: 'Установить зависимости сейчас',
+            initial: false,
+            active: 'да',
+            inactive: 'нет',
+        },
+    ];
+}

package/build/run.d.ts

@@ -0,0 +1,9 @@
+import { type CliFlags } from './defaults';
+export type RunInitOptions = {
+    targetDirArg?: string;
+    cwd?: string;
+    aruiScriptsVersion?: string;
+    flags?: CliFlags;
+};
+export declare function runInit(options?: RunInitOptions): Promise<void>;
+export declare function resolveCdPath(baseCwd: string, targetDir: string): string | null;