create-finalbuildwp 0.1.0

package/README.md

@@ -0,0 +1,51 @@
+# create-finalbuildwp
+
+CLI для создания папки проекта (**например `my-site`**) с `composer.json`, который тянет **`finalbuildwp/wordpress-build`** из вашего Git. После `composer install` ядро WordPress оказывается **в корне этой папки** (как в основном репозитории сборки), а не в `web/`.
+
+## Требования
+
+- **Node.js** 18+
+- **Composer** и **PHP** (для шага установки зависимостей)
+- Доступ на **чтение** к закрытому репозиторию с пакетом (коллаборатор); на машине — тот же SSH/HTTPS, что для `git clone`
+
+## Использование
+
+Опубликованный пакет (после `npm publish`):
+
+```bash
+npm create finalbuildwp@latest
+```
+
+или:
+
+```bash
+npx create-finalbuildwp@latest my-site
+```
+
+Локально из клона **finalBuildWP**:
+
+```bash
+cd create-finalbuildwp
+npm install
+node bin/create-finalbuildwp.js my-site
+```
+
+Флаги:
+
+- **`--force`** — использовать непустую папку (файлы шаблона перезапишут одноимённые)
+- **`--skip-composer`** — только сгенерировать файлы, без `composer install`
+- **`COMPOSER_BIN`** — путь к исполняемому файлу Composer, если не в `PATH`
+
+## Публикация на npm
+
+```bash
+cd create-finalbuildwp
+npm login
+npm publish --access public
+```
+
+При **scoped** имени (`@org/create-finalbuildwp`) добавьте в `package.json` `"publishConfig": { "access": "public" }` при необходимости.
+
+## Связь с репозиторием сборки
+
+Шаблон повторяет смысл [consumer-example/composer.json](../consumer-example/composer.json): корневой проект, `repositories` → VCS, `require` → `finalbuildwp/wordpress-build`. Document root веб-сервера = папка проекта.

package/bin/create-finalbuildwp.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const prompts = require('prompts');
+
+function parseArgs(argv) {
+  const force = argv.includes('--force');
+  const skipComposer = argv.includes('--skip-composer');
+  const pos = argv.filter((a) => !a.startsWith('-'));
+  return {
+    force,
+    skipComposer,
+    projectDir: pos[0] || null,
+  };
+}
+
+function isSafeRelativeDir(name) {
+  if (!name || typeof name !== 'string') return false;
+  const trimmed = name.trim();
+  if (!trimmed) return false;
+  if (trimmed.includes('..')) return false;
+  if (path.isAbsolute(trimmed)) return false;
+  // одна или несколько сегментов без странных символов
+  return /^[\w./\\-]+$/.test(trimmed);
+}
+
+async function main() {
+  const cwd = process.cwd();
+  const args = parseArgs(process.argv.slice(2));
+
+  let projectDir = args.projectDir;
+  if (!projectDir) {
+    const r = await prompts(
+      {
+        type: 'text',
+        name: 'projectDir',
+        message: 'Папка проекта (document root = её корень; WordPress будет здесь же)',
+        initial: 'my-site',
+        validate: (v) =>
+          isSafeRelativeDir(v) ? true : 'Укажите относительное имя папки (без ..)',
+      },
+      { onCancel: () => process.exit(1) }
+    );
+    if (!r.projectDir) process.exit(1);
+    projectDir = r.projectDir.trim();
+  }
+
+  if (!isSafeRelativeDir(projectDir)) {
+    console.error('Некорректное имя папки проекта.');
+    process.exit(1);
+  }
+
+  const target = path.resolve(cwd, projectDir);
+
+  const r2 = await prompts(
+    [
+    {
+      type: 'text',
+      name: 'composerName',
+      message: 'Имя пакета в composer.json (vendor/name)',
+      initial: 'my-company/my-wordpress-site',
+      validate: (v) =>
+        /^[a-z0-9]([_.-]?[a-z0-9]+)*\/[a-z0-9]([_.-]?[a-z0-9]+)*$/i.test(v)
+          ? true
+          : 'Формат: vendor/package (строчные буквы, цифры, - . _)',
+    },
+    {
+      type: 'text',
+      name: 'vcsUrl',
+      message: 'URL Git с репозиторием finalbuildwp/wordpress-build (приватный или публичный)',
+      validate: (v) => {
+        const s = (v || '').trim();
+        if (!s) return 'Укажите URL';
+        if (s.startsWith('git@')) return true;
+        if (/^https?:\/\//i.test(s)) return true;
+        return 'Нужен https://... или git@...';
+      },
+    },
+    {
+      type: 'text',
+      name: 'packageConstraint',
+      message: 'Версия пакета finalbuildwp/wordpress-build',
+      initial: 'dev-main',
+      validate: (v) => ((v || '').trim() ? true : 'Укажите ограничение версии'),
+    },
+    ],
+    { onCancel: () => process.exit(1) }
+  );
+
+  if (!r2.composerName || !r2.vcsUrl || !r2.packageConstraint) {
+    process.exit(1);
+  }
+
+  const vcsUrl = r2.vcsUrl.trim();
+  const composerName = r2.composerName.trim();
+  const packageConstraint = r2.packageConstraint.trim();
+
+  if (fs.existsSync(target)) {
+    const entries = fs.readdirSync(target);
+    if (entries.length > 0 && !args.force) {
+      console.error(
+        `Папка «${projectDir}» не пуста. Удалите файлы, укажите другое имя или запустите с флагом --force.`
+      );
+      process.exit(1);
+    }
+  } else {
+    fs.mkdirSync(target, { recursive: true });
+  }
+
+  const tplRoot = path.join(__dirname, '..', 'templates');
+  const files = ['composer.json', '.gitignore', 'README.md'];
+
+  for (const file of files) {
+    const src = path.join(tplRoot, file);
+    let content = fs.readFileSync(src, 'utf8');
+    if (file === 'composer.json') {
+      content = content
+        .replace(/\{\{VCS_URL\}\}/g, vcsUrl)
+        .replace(/\{\{COMPOSER_NAME\}\}/g, composerName)
+        .replace(/\{\{PACKAGE_CONSTRAINT\}\}/g, packageConstraint);
+    }
+    fs.writeFileSync(path.join(target, file), content, 'utf8');
+  }
+
+  console.log(`\nСоздан проект: ${target}\n`);
+
+  if (args.skipComposer) {
+    console.log('Пропуск composer (--skip-composer). Выполните в папке проекта: composer install\n');
+    return;
+  }
+
+  const composerBin = process.env.COMPOSER_BIN || 'composer';
+  const isWin = process.platform === 'win32';
+  const result = spawnSync(composerBin, ['install'], {
+    cwd: target,
+    stdio: 'inherit',
+    shell: isWin,
+    env: process.env,
+  });
+
+  if (result.error) {
+    console.error(
+      '\nНе удалось запустить Composer. Установите его и выполните в папке проекта:\n  composer install\n'
+    );
+    process.exit(1);
+  }
+
+  process.exit(result.status === null ? 1 : result.status);
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "create-finalbuildwp",
+  "version": "0.1.0",
+  "description": "Создаёт проект my-site с finalbuildwp/wordpress-build: ядро WordPress в корне папки (не web/)",
+  "bin": {
+    "create-finalbuildwp": "bin/create-finalbuildwp.js"
+  },
+  "files": [
+    "bin",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "wordpress",
+    "finalbuildwp",
+    "composer",
+    "scaffold",
+    "create-project"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "prompts": "^2.4.2"
+  }
+}

package/templates/README.md

@@ -0,0 +1,16 @@
+# WordPress site
+
+Сгенерировано **create-finalbuildwp**. Ядро WordPress после `composer install` окажется **в корне этой папки** (`index.php`, `wp-admin/`, …), рядом с `composer.json` и `vendor/`.
+
+## Дальше
+
+1. У вас должен быть **доступ на чтение** к закрытому репозиторию с пакетом `finalbuildwp/wordpress-build` (вас добавили коллаборатором). Используйте тот же Git (SSH или HTTPS), что и для `git clone`.
+2. Если ещё не выполняли: в корне проекта **`composer install`**.
+3. Скопируйте **`.env.example` → `.env`**, настройте БД и URL (**`WP_HOME`** / **`WP_SITEURL`**).
+4. **Document root** веб-сервера = **эта папка** (корень проекта). Закройте доступ к **`/vendor/`** и **`.env`**.
+
+## Обновление сборки
+
+```bash
+composer update finalbuildwp/wordpress-build
+```

package/templates/composer.json

@@ -0,0 +1,22 @@
+{
+    "name": "{{COMPOSER_NAME}}",
+    "description": "WordPress site (finalbuildwp/wordpress-build, core in project root)",
+    "type": "project",
+    "repositories": [
+        {
+            "type": "vcs",
+            "url": "{{VCS_URL}}"
+        }
+    ],
+    "require": {
+        "php": ">=7.4",
+        "finalbuildwp/wordpress-build": "{{PACKAGE_CONSTRAINT}}"
+    },
+    "config": {
+        "allow-plugins": {
+            "johnpbloch/wordpress-core-installer": true,
+            "composer/installers": true,
+            "finalbuildwp/wordpress-build": true
+        }
+    }
+}