create-mirta 0.3.5 → 0.4.3

package/locales/en-US.json

@@ -0,0 +1,109 @@
+{
+  "title": "Your framework for smart home automations",
+
+  "yes": "Yes",
+  "no": "No",
+
+  "args.errorHeader": "Invalid CLI {count, plural, one{argument} other{arguments}}",
+  "args.unknownOption": "{option} → unknown option",
+  "args.unknownOptionSuggest": "{option} → did you mean {suggestion}?",
+  "args.missingValue": "{option} → missing value",
+
+  "label.debug": "Debug",
+  "label.info": "Info",
+  "label.warning": "Warning",
+  "label.error": "Error",
+  "label.success": "Success",
+  "label.canceled": "Canceled",
+
+  "hint.recommended": "Recommended",
+  "hint.blocked": "Not supported by template",
+  "hint.select": "Use arrow keys. Enter to submit",
+
+  "captions.intro": "Project Settings",
+  "captions.deploy": "Deploy Settings",
+
+  "projectType.prompt": "Project Type",
+  "projectType.classic": "Classic — for Wiren Board controller",
+  "projectType.mono": "Mono — for related projects and NPM",
+
+  "projectFolder.prompt": "Project folder",
+
+  "packageName.prompt": "Package name",
+  "packageName.tooLong": "Exceeds {maxLength} characters",
+  "packageName.invalidFormat": "Invalid format",
+
+  "template.select": "Select template",
+  "template.notFound": "Template '{name}' not found",
+
+  "templates.starter.name": "Starter — Base Project",
+  "templates.starter.description": "A solid foundation",
+
+  "templates.store.name": "Store — Shared State",
+  "templates.store.description": "Access data from any script",
+
+  "templates.package.name": "Package — wb-rules modules for NPM",
+  "templates.package.description": "Code distribution",
+
+  "templates.sites.name": "Sites — connected projects",
+  "templates.sites.description": "Home and cottage, office",
+
+  "features.select": "Select features",
+  "features.instructions": "Navigate: ↑ / ↓\nSelect: ← / → / Space\nSelect all: A\nComplete answer: Enter",
+
+  "features.examples.name": "Examples — Quick Start",
+  "features.examples.description": "Typical use of the template and features",
+
+  "features.connection.name": "SSH — File Transfer",
+  "features.connection.description": "Configure connection to the controller",
+
+  "features.eslint.name": "ESLint — Static Analysis",
+  "features.eslint.description": "Enforce code style and catch errors",
+
+  "features.vitest.name": "Vitest — Unit Testing",
+  "features.vitest.description": "Test and debug without the controller",
+
+  "features.package.name": "Package — NPM module",
+  "features.package.description": "Publish your code to NPM",
+
+  "features.github.name": "GitHub — Repository & CI",
+  "features.github.description": "Set metadata and CI/CD workflows",
+
+  "feature.skipped": "Feature {feature} skipped — not supported by template",
+
+  "connection.caption": "Controller Connection Settings",
+
+  "ssh.username": "SSH Username",
+  "ssh.hostname": "SSH Hostname",
+  "ssh.port": "SSH Port",
+  "ssh.rutoken": "Use Rutoken ECP?",
+
+  "github.caption": "GitHub Settings",
+
+  "github.owner.prompt": "Repository owner",
+  "github.repository.prompt": "Repository name",
+  "github.branch.prompt": "Repository main branch",
+
+  "overwrite.notEmpty": "Location {path} is not empty",
+  "overwrite.prompt": "Remove existing files before continuing?",
+
+  "package.caption": "Package Settings",
+
+  "dependencies.prompt": "Install project dependencies?",
+  "dependencies.answer.yesUsing": "Yes, using {manager}",
+  "dependencies.answer.no": "No, I will handle that myself",
+
+  "step.canceled": "Operation canceled",
+  "step.removingFiles": "Removing files...",
+  "step.scaffolding": "Scaffolding project in {folder}",
+  "step.scaffolded": "The project has been scaffolded",
+  "step.installingDependencies": "Calling the package manager",
+
+  "validation.required": "Must be provided",
+  "validation.invalidFormat": "Invalid format",
+
+  "project.outsideRoot": "Cannot create project outside current directory",
+  "project.denyOverwrite": "Target directory is not empty",
+
+  "load.noTemplates": "No templates found for project type '{type}'"
+}

package/locales/ru-RU.json

@@ -0,0 +1,109 @@
+{
+  "title": "Ваш фреймворк для современных автоматизаций",
+
+  "yes": "Да",
+  "no": "Нет",
+
+  "args.errorHeader": "{count, plural, one{Недопустимый аргумент} other{Недопустимые аргументы}} CLI",
+  "args.unknownOption": "{option} → неизвестный параметр",
+  "args.unknownOptionSuggest": "{option} → возможно, {suggestion}?",
+  "args.missingValue": "{option} → отсутствует значение",
+
+  "label.debug": "Отладка",
+  "label.info": "Инфо",
+  "label.warning": "Предупреждение",
+  "label.error": "Ошибка",
+  "label.success": "Успешно",
+  "label.canceled": "Отмена",
+
+  "hint.recommended": "Рекомендуется",
+  "hint.blocked": "Не поддерживается шаблоном",
+  "hint.select": "Используйте стрелки. Enter — подтвердить",
+
+  "captions.intro": "Настройки проекта",
+  "captions.deploy": "Настройки развёртывания",
+
+  "projectType.prompt": "Тип проекта",
+  "projectType.classic": "Классический — для контроллера Wiren Board",
+  "projectType.mono": "Моно — для связанных проектов и NPM",
+
+  "projectFolder.prompt": "Папка проекта",
+
+  "packageName.prompt": "Имя пакета",
+  "packageName.tooLong": "Превышает {maxLength} символов",
+  "packageName.invalidFormat": "Неверный формат",
+
+  "template.select": "Выберите шаблон",
+  "template.notFound": "Шаблон '{name}' не найден",
+
+  "templates.starter.name": "Стартер — начальный проект",
+  "templates.starter.description": "Сильная основа",
+
+  "templates.store.name": "Store — управление состоянием",
+  "templates.store.description": "Доступ к данным из любого скрипта",
+
+  "templates.package.name": "Пакет — модули wb-rules для NPM",
+  "templates.package.description": "Распространение кода",
+
+  "templates.sites.name": "Sites — связанные проекты",
+  "templates.sites.description": "Дом и дача, работа",
+
+  "features.select": "Выберите расширенные возможности",
+  "features.instructions": "Навигация: ↑ / ↓\nВыбрать: ← / → / Пробел\nВыбрать всё: A\nПодтвердить: Enter",
+
+  "features.examples.name": "Примеры — быстрый старт",
+  "features.examples.description": "Типовое использование шаблона и опций",
+
+  "features.connection.name": "SSH — передача файлов",
+  "features.connection.description": "Настроить подключение к контроллеру",
+
+  "features.eslint.name": "ESLint — статический анализ",
+  "features.eslint.description": "Контроль стиля и ошибок",
+
+  "features.vitest.name": "Vitest — модульные тесты",
+  "features.vitest.description": "Тесты и отладка без контроллера",
+
+  "features.package.name": "Пакет — модуль для NPM",
+  "features.package.description": "Распространение кода",
+
+  "features.github.name": "GitHub — репозиторий и CI",
+  "features.github.description": "Задать метаданные репозитория и настроить CI/CD",
+
+  "feature.skipped": "Функция {feature} пропущена — не поддерживается шаблоном",
+
+  "connection.caption": "Настройки подключения к контроллеру",
+
+  "ssh.username": "Пользователь SSH",
+  "ssh.hostname": "Хост SSH",
+  "ssh.port": "Порт SSH",
+  "ssh.rutoken": "Использовать Рутокен ЭЦП?",
+
+  "github.caption": "Параметры репозитория",
+
+  "github.owner.prompt": "Владелец репозитория (owner)",
+  "github.repository.prompt": "Имя репозитория",
+  "github.branch.prompt": "Основная ветка репозитория",
+
+  "package.caption": "Настройки пакета",
+
+  "overwrite.notEmpty": "Расположение {path} уже содержит файлы",
+  "overwrite.prompt": "Удалить существующие файлы перед продолжением?",
+
+  "dependencies.prompt": "Установить зависимости проекта?",
+  "dependencies.answer.yesUsing": "Да, с помощью {manager}",
+  "dependencies.answer.no": "Нет, я сделаю это самостоятельно",
+
+  "step.canceled": "Операция прервана",
+  "step.removingFiles": "Удаление файлов...",
+  "step.scaffolding": "Создание проекта в {folder}",
+  "step.scaffolded": "Проект создан",
+  "step.installingDependencies": "Вызов менеджера пакетов",
+
+  "validation.required": "Требуется указать значение",
+  "validation.invalidFormat": "Неверный формат",
+
+  "project.outsideRoot": "Невозможно создать проект вне текущей директории",
+  "project.denyOverwrite": "Целевая директория не пуста",
+
+  "load.noTemplates": "Шаблоны для типа проекта '{type}' не найдены"
+}

package/package.json

@@ -1,18 +1,26 @@
 {
   "name": "create-mirta",
-  "description": "🛠️ The recommended way to start a Mirta project.",
-  "version": "0.3.5",
+  "description": "🛠️ The recommended way to start a Mirta project",
+  "version": "0.4.3",
   "license": "Unlicense",
   "keywords": [
     "mirta",
     "wb-rules"
   ],
-  "engines": {
-    "node": ">=20.6.0"
-  },
   "type": "module",
+  "imports": {
+    "#*": "./src/*.js",
+    "#i18n": "./src/i18n/index.js",
+    "#jsonc": "./src/jsonc/index.js",
+    "#errors": "./src/errors/index.js",
+    "#runners": "./src/runners/index.js",
+    "#locales/*": "./locales/*.json"
+  },
   "files": [
     "dist",
+    "assets",
+    "locales",
+    "templates",
     "LICENSE",
     "README.md"
   ],
@@ -29,28 +37,23 @@
     "url": "https://github.com/wb-mirta/core/issues"
   },
   "dependencies": {
-    "@clack/prompts": "^0.11.0",
+    "prompts": "^2.4.2",
     "chalk": "^5.6.2",
-    "ejs": "^3.1.10",
-    "fs-extra": "^11.3.2",
     "gradient-string": "^3.0.0",
-    "is-unicode-supported": "^2.1.0",
-    "lodash.merge": "^4.6.2"
+    "jsonc-parser": "^3.3.1",
+    "@mirta/i18n": "0.4.3",
+    "@mirta/staged-args": "0.4.3",
+    "@mirta/basics": "0.4.3"
   },
   "devDependencies": {
-    "@eslint/js": "^9.38.0",
-    "@stylistic/eslint-plugin": "^5.5.0",
-    "@types/cross-spawn": "^6.0.6",
-    "@types/ejs": "^3.1.5",
-    "@types/fs-extra": "^11.0.4",
-    "@types/lodash.merge": "^4.6.9",
-    "eslint": "^9.38.0",
-    "@vitest/eslint-plugin": "^1.3.23",
-    "globals": "^16.4.0",
-    "typescript-eslint": "^8.46.2"
+    "@types/prompts": "^2.4.9"
+  },
+  "engines": {
+    "node": ">=24.12.0"
   },
   "scripts": {
-    "clean": "rimraf dist",
-    "build:mono": "pnpm clean && rollup -c node:@mirta/rollup/config --config-package --config-skip-exports"
+    "build:mono": "rollup -c node:@mirta/rollup/config-package --config-skip-exports",
+    "i18n:shape-gen": "node ../../scripts/i18n/shape-gen.mjs",
+    "create": "node dist/index.mjs"
   }
 }

package/templates/classic/starter/content/package.json

@@ -0,0 +1,11 @@
+{
+  "imports": {
+    "#wb/*": "./src/wb-rules/*.js",
+    "#wbm/*": "./src/wb-rules-modules/*.js"
+  },
+  "scripts": {
+    "build": "cross-env NODE_ENV=production rollup -c node:@mirta/rollup/config",
+    "build:dev": "rollup -c node:@mirta/rollup/config",
+    "wb:deploy": "mirta deploy"
+  }
+}

package/{dist/templates/config/typescript → templates/classic/starter/content}/tsconfig.json

@@ -2,11 +2,6 @@
   "extends": "@mirta/tsconfig",
   "compilerOptions": {
     "rootDir": ".",
-    "paths": {
-      "@wbm/*": [
-        "./src/wb-rules-modules/*"
-      ]
-    },
     "types": [
       "@mirta/globals",
       "node"

package/{dist/templates/eslint/eslint.config.mjs.ejs → templates/classic/starter/features/eslint/eslint.config.mjs.tt}

@@ -3,9 +3,9 @@ import globals from 'globals'
 import globalsMirta from '@mirta/globals/eslint'
 import tseslint from 'typescript-eslint'
 import stylistic from '@stylistic/eslint-plugin'
-<%_ if (addVitest) { _%>
+{{#if features.vitest}}
 import vitest from '@vitest/eslint-plugin'
-<%_ } _%>
+{{/if features.vitest}}
 import { defineConfig, globalIgnores } from 'eslint/config'
 
 export default defineConfig([
@@ -24,11 +24,11 @@ export default defineConfig([
     },
   },
   // TypeScript Defaults
-  tseslint.configs.strictTypeChecked.map(config => ({
+  ...tseslint.configs.strictTypeChecked.map(config => ({
     ...config,
     files: ['**/*.ts'],
   })),
-  tseslint.configs.stylisticTypeChecked.map(config => ({
+  ...tseslint.configs.stylisticTypeChecked.map(config => ({
     ...config,
     files: ['**/*.ts'],
   })),
@@ -59,6 +59,11 @@ export default defineConfig([
           'ignoreRestSiblings': true,
         },
       ],
+      '@typescript-eslint/prefer-nullish-coalescing': ['error', {
+        'ignorePrimitives': {
+          'string': true,
+        },
+      }],
     },
     languageOptions: {
       parserOptions: {
@@ -91,7 +96,7 @@ export default defineConfig([
       }],
     },
   },
-<%_ if (addVitest) { _%>
+{{#if features.vitest}}
   // Vitest Defaults
   {
     files: ['tests/**'],
@@ -107,7 +112,7 @@ export default defineConfig([
       },
     },
   },
-<%_ } _%>
+{{/if features.vitest}}
   globalIgnores([
     'node_modules/',
     'dist/',

package/{dist/templates/base/_env → templates/classic/starter/features/examples/_.env}

@@ -1,4 +1,4 @@
 APP_FRAMEWORK='Mirta'
 
 # Example environment variable with expansion
-APP_NAME='${APP_FRAMEWORK} Project'
+APP_NAME=`${APP_FRAMEWORK} Project`

package/templates/classic/starter/features/examples/src/wb-rules/01-counter.ts

@@ -0,0 +1,12 @@
+import { useCounter } from '#wbm/counter'
+
+log('Script: {}', __filename)
+
+// Использует счетчик из модуля counter
+const counter = useCounter()
+
+// Увеличивает значение счетчика на 1
+counter.increment()
+
+// Выводит в лог текущее значение счетчика
+log('Counter Value: {}', counter.count)

package/templates/classic/starter/features/examples/src/wb-rules-modules/counter.ts

@@ -0,0 +1,42 @@
+/**
+ * Простой счётчик с возможностью инкремента и чтения текущего значения
+ *
+ **/
+export interface Counter {
+
+  /** Позволяет прочесть значение счётчика. */
+  get count(): number
+
+  /** Увеличивает значение счётчика на единицу. */
+  increment(): void
+
+}
+
+/**
+ * Функция-построитель простого счётчика
+ *
+ * @returns Экземпляр счётчика
+ *
+ **/
+export function useCounter(): Counter {
+
+  // Значение счётчика - его индивидуальное состояние
+  let count = 0
+
+  return {
+
+    get count() {
+
+      return count
+
+    },
+
+    increment() {
+
+      count += 1
+
+    }
+
+  }
+
+}

package/templates/classic/starter/features/examples-vitest/tests/wb-rules-modules/counter.test.ts

@@ -0,0 +1,56 @@
+import { useCounter } from '#wbm/counter'
+
+describe('Counter', () => {
+
+  let counter: ReturnType<typeof useCounter>
+
+  beforeEach(() => {
+
+    counter = useCounter()
+
+  })
+
+  it('should start with count equal to 0', () => {
+
+    expect(counter.count).toBe(0)
+
+  })
+
+  it('should increment count by 1 when increment is called', () => {
+
+    counter.increment()
+    expect(counter.count).toBe(1)
+
+    counter.increment()
+    expect(counter.count).toBe(2)
+
+  })
+
+  it('should not allow direct modification of count', () => {
+
+    const initial = counter.count
+
+    // @ts-expect-error – подавляем ошибку этапа компиляции
+    counter.count = 100
+
+    // Значение не должно измениться
+    expect(counter.count).toBe(initial)
+
+  })
+
+  it('should have independent state for each instance', () => {
+
+    const counter1 = useCounter()
+    const counter2 = useCounter()
+
+    counter1.increment()
+    counter1.increment()
+
+    counter2.increment()
+
+    expect(counter1.count).toBe(2)
+    expect(counter2.count).toBe(1)
+
+  })
+
+})

package/templates/classic/starter/features/vitest/package.json

@@ -0,0 +1,10 @@
+{
+  "scripts": {
+    "test": "vitest run --config @mirta/testing/config"
+  },
+  "devDependencies": {
+    "@mirta/testing": "0.4.3",
+    "vitest": "^4.0.8",
+    "vitest-mock-extended": "^3.1.0"
+  }
+}

package/templates/classic/starter/features/vitest-eslint/package.json

@@ -0,0 +1,5 @@
+{
+  "devDependencies": {
+    "@vitest/eslint-plugin": "^1.6.4"
+  }
+}

package/templates/classic/starter/template.json

@@ -0,0 +1,10 @@
+{
+  "extends": "base",
+  "features": {
+    "compound": [
+      "examples-vitest",
+      "vitest-eslint"
+    ]
+  },
+  "order": 1010
+}

package/{dist/templates/config/store → templates/classic/store/content}/package.json

@@ -1,5 +1,5 @@
 {
   "dependencies": {
-    "@mirta/store": "0.3.5"
+    "@mirta/store": "0.4.3"
   }
 }

package/templates/classic/store/features/examples/src/wb-rules/01-counter.ts

@@ -0,0 +1,13 @@
+import { useCounter } from '#wbm/counter'
+
+log('Script: {}', __filename)
+
+// Использует счетчик из модуля counter
+const counter = useCounter()
+
+// Увеличивает значение счетчика на 2
+counter.increment()
+counter.increment()
+
+// Выводит в лог текущее значение счетчика
+log('Counter Value: {}', counter.count)

package/templates/classic/store/features/examples/src/wb-rules/02-counter.ts

@@ -0,0 +1,19 @@
+import { useCounter } from '#wbm/counter'
+import { useCounterStore } from '#wbm/counter-store'
+
+log('Script: {}', __filename)
+
+// Использует счетчик из модуля counter
+const counter = useCounter()
+
+// Увеличивает значение счетчика на 2
+counter.increment()
+counter.increment()
+
+// Выводит в лог текущее значение счетчика
+log('Counter Value: {}', counter.count)
+
+const store = useCounterStore()
+
+// Выводит в лог значение напрямую из store
+log('Value from store: {}, double from getter: {}', store.count, store.double)

package/templates/classic/store/features/examples/src/wb-rules-modules/counter-store.ts

@@ -0,0 +1,33 @@
+import { defineStore } from '@mirta/store'
+
+export const useCounterStore = defineStore('counter', {
+
+  state: () => ({
+
+    count: 0,
+
+  }),
+
+  getters: {
+
+    double: state => state.count * 2,
+
+  },
+
+  actions: {
+
+    increment() {
+
+      this.count++
+
+    },
+
+    setCount(value: number) {
+
+      this.count = value
+
+    },
+
+  },
+
+})

package/templates/classic/store/features/examples/src/wb-rules-modules/counter.ts

@@ -0,0 +1,44 @@
+import { useCounterStore } from '#wbm/counter-store'
+
+/**
+ * Простой счётчик с возможностью инкремента и чтения текущего значения
+ *
+ **/
+export interface Counter {
+
+  /** Позволяет прочесть значение счётчика. */
+  get count(): number
+
+  /** Увеличивает значение счётчика на единицу. */
+  increment(): void
+
+}
+
+/**
+ * Функция-построитель простого счётчика
+ *
+ * @returns Экземпляр счётчика
+ *
+ **/
+export function useCounter(): Counter {
+
+  // Значение счётчика - глобальное состояние
+  const store = useCounterStore()
+
+  return {
+
+    get count() {
+
+      return store.count
+
+    },
+
+    increment() {
+
+      store.increment()
+
+    },
+
+  }
+
+}