@nan0web/ui-cli 1.0.0 → 1.0.2

package/src/ui/input.test.js

@@ -1,27 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-import { Input, ask, createInput } from './input.js'
-
-describe('Input utilities', () => {
-	it('should create Input instance', () => {
-		const input = new Input()
-		assert.equal(input.value, '')
-		assert.equal(input.cancelled, false)
-	})
-
-	it('should handle cancellation stops', () => {
-		const input = new Input({ stops: ['quit'] })
-		input.value = 'quit'
-		assert.equal(input.cancelled, true)
-	})
-
-	it('should create input handler', () => {
-		const handler = createInput()
-		assert.equal(typeof handler, 'function')
-	})
-
-	it('should create input handler with stops', () => {
-		const handler = createInput(['exit'])
-		assert.equal(typeof handler, 'function')
-	})
-})

package/src/ui/select.test.js

@@ -1,34 +0,0 @@
-import { describe, it } from 'node:test'
-import assert from 'node:assert/strict'
-import { select } from './select.js'
-import { CancelError } from '@nan0web/ui/core'
-
-describe('Select utility', () => {
-	it('should throw error for empty options', async () => {
-		await assert.rejects(
-			select({
-				title: 'Test',
-				prompt: 'Choose:',
-				options: [],
-				console: console
-			}),
-			Error
-		)
-	})
-
-	it('should throw CancelError for cancellation', async () => {
-		// Мокаємо ask для скасування
-		const mockAsk = () => Promise.resolve({ cancelled: true })
-
-		await assert.rejects(
-			select({
-				title: 'Test',
-				prompt: 'Choose:',
-				options: ['option1', 'option2'],
-				console: console,
-				ask: mockAsk
-			}),
-			CancelError
-		)
-	})
-})

package/system.md

@@ -1,99 +0,0 @@
----
-PROJECT_NAME: "ui-cli"
-VERSION: "1.0.0"
-CORE_PRINCIPLE: "Універсальний CLI‑адаптер – простота + надійність."
-VALIDATION_PHRASE: "UI‑CLI відповідає"
-FAILURE_RESPONSE: "Це — не UI‑CLI. Я не можу працювати далі."
-IDENTITY_MODEL: "Я / тИ / мИ / вИ"
-LOGIC_BASE: "Запит → відповідь → валідація → результат"
----
-
-# ✨ UI‑CLI – системне керівництво
-
-> **Мета** – надати мінімальний, беззалежний інтерфейс вводу/виводу для Node‑CLI‑додатків, що працює без сторонніх бібліотек, лише чистий JavaScript.
-
-## 📦 Основні компоненти
-
-| Компонент | Опис | Експорт |
-|----------|------|---------|
-| `CLIInputAdapter` | Клас‑адаптер, що обгортає процес запиту форм, окремих полів та списків. | `default`, `CLIInputAdapter` |
-| `Input` | Об’єкт, який зберігає рядок вводу та статус скасування. | `Input` |
-| `CancelError` | Помилка, кидається при скасуванні запиту. | `CancelError` |
-| `ask` | Проста функція‑проміс, що виводить питання та повертає відповідь. | `ask` |
-| `createInput` | Фабрика, що створює кастомізований обробник вводу з ключовими словами «stop». | `createInput` |
-| `select` | Генерує список варіантів, приймає номер, повертає обраний `value`. | `select` |
-| `next` | Очікує будь‑яку клавішу (можна вказати схеми). | `next` |
-| `pause` | Пауза на вказану кількість мілісекунд. | `pause` |
-
-## 🚀 Швидкий старт
-
-```bash
-npm i @nan0web/ui-cli
-```
-
-```js
-import {
-	CLIInputAdapter,
-	ask,
-	select,
-	next,
-	pause,
-	CancelError,
-	Input,
-	createInput,
-} from '@nan0web/ui-cli'
-
-const adapter = new CLIInputAdapter()
-
-// Приклад: простий запит
-const name = await adapter.ask('Ваше ім’я?')
-console.log('Вітаємо,', name)
-
-// Приклад: вибір зі списку
-const lang = await adapter.select({
-	title: 'Виберіть мову',
-	prompt: 'Введіть номер: ',
-	options: new Map([['en', 'English'], ['uk', 'Українська']]),
-	console: console,
-})
-console.log('Обрана мова:', lang.value)
-```
-
-## 🛠️ Тестування (TDD)
-
-- **Команда** `npm test` – запускає всі `*.test.js` у `src/`.
-- **Coverage** `npm run test:coverage` – мінімум 90 %.
-- **Документація** `npm run test:docs` – генерує `README.md` з тестових блоків.
-- **Release** `npm run test:release` – перевірка `releases/**/*.test.js`.
-
-Кожна публічна функція/клас має **принаймні один тест** у `.test.js` поряд з файлом коду.
-
-## 🧭 Доступні CLI‑методи
-
-| Метод | Параметри | Повертає | Опис |
-|-------|-----------|----------|------|
-| `ask(question)` | `string` – підказка | `Promise<string>` | Запит користувачу, повертає введений рядок. |
-| `createInput(stops?)` | `string[]` – слова‑сигнали | `Promise<Input>` | Створює інстанс `Input` з автоскасуванням. |
-| `select(config)` | `{title, prompt, options, console, ask?}` | `Promise<{index, value}>` | Виводить нумерований список, повертає вибір. |
-| `next(conf?)` | `string|array` – послідовність клавіш | `Promise<string>` | Чекає на натискання клавіші (або набору). |
-| `pause(ms)` | `number` – мілісекунди | `Promise<void>` | Затримка виконання. |
-| `CLIInputAdapter.requestForm(form, {silent})` | `UIForm` + опції | `Promise<FormMessage>` | Показує форму, проходить по полях, валідує, повертає результат або `escaped:true`. |
-| `CLIInputAdapter.requestSelect(config)` | `config` (аналог `select`) | `Promise<InputMessage>` | Викликає `select`, обгортає результат у `InputMessage`. |
-| `CLIInputAdapter.requestInput(config)` | `{prompt, id, label, name}` | `Promise<InputMessage>` | Простий рядковий запит. |
-
-## 📝 Рекомендації для розробників
-
-1. **JSDoc** – кожна функція/клас має повний опис (`@param`, `@returns`, `@throws`). Це забезпечує автодоповнення у IDE без TypeScript.
-2. **Імпорти** – використовуйте `import { … } from '@nan0web/ui-cli'` лише в точках входу.
-3. **Структура** – залишайте `src/` чистим, `tests/` поруч, `types/` лише декларації (`*.d.ts`), `README.md` генерується з тестів.
-4. **Локальність** – UI‑текст передається через `i18n` (передача функції `t`). В `playground` вже реалізовано приклад.
-5. **Нульові залежності** – не підключайте сторонні пакети у `ui-cli`; лише Node‑вбудовані (`readline`, `process`).
-
-## 🌐 Підтримка та внесок
-
-- **Bug‑репорт** – відкривайте Issue у репозиторії.
-- **Pull‑request** – додайте нові функції з тестами та оновленою документацією.
-- **CI** – автоматично запускає `npm test` та `npm run test:coverage`.
-
-> **UI‑CLI відповідає** – коли команда виконується без помилок, коли тестове покриття достатнє, коли документація генерується без «шуму».
-

package/tsconfig.json

@@ -1,23 +0,0 @@
-{
-	"compilerOptions": {
-		"target": "esnext",
-		"module": "nodenext",
-		"lib": ["esnext"],
-		"declaration": true,
-		"declarationMap": false,
-		"emitDeclarationOnly": true,
-		"outDir": "./types",
-		"rootDir": "./src",
-		"strict": true,
-		"esModuleInterop": true,
-		"skipLibCheck": true,
-		"forceConsistentCasingInFileNames": true,
-		"moduleResolution": "nodenext",
-		"allowSyntheticDefaultImports": true,
-		"noImplicitAny": false,
-		"allowJs": true,
-		"checkJs": true
-	},
-	"include": ["src/**/*"],
-	"exclude": ["node_modules", "src/**/*.test.js"]
-}

package/types/test/ReadLine.d.ts

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

package/types/ui/errors.d.ts

@@ -1,3 +0,0 @@
-export class CancelError extends Error {
-    constructor(message?: string);
-}