@via-profit/ability 2.1.0 → 3.0.1

package/CHANGELOG.md

@@ -0,0 +1,64 @@
+# Changelog
+
+## [3.0.1] - 2026-03-19
+
+## Добавлено
+
+### 1. **Лицензия MIT** (`LICENSE`)
+
+- Добавлен официальный файл лицензии MIT от Via Profit
+
+### 2. **Класс `AbilityExplain.ts`**
+
+- Новый класс для получения человекочитаемых объяснений результатов проверки
+- Классы-наследники:
+    - `AbilityExplainRule` - объяснение для правила
+    - `AbilityExplainRuleSet` - объяснение для группы правил
+    - `AbilityExplainPolicy` - объяснение для политики
+- Метод `toString()` форматирует вывод с отступами и символами ✓/✗
+
+---
+
+## Обновлено
+
+### **AbilityParser.ts** (полная переработка)
+
+- **Было**: Базовая генерация типов
+- **Стало**: Расширенная система генерации TypeScript типов
+- Новые методы:
+    - `determineTypeFromRule()` - определение типа на основе правила
+    - `getArrayType()` - обработка массивов
+    - `getPrimitiveType()` - определение примитивных типов
+    - `buildNestedStructure()` - трансформация плоской структуры во вложенную
+    - `formatTypeDefinitions()` - форматирование финального вывода
+    - `formatNestedObject()` - рекурсивное форматирование объектов
+
+### **AbilityRule.ts**
+
+- `id` и `name` теперь опциональные (`?`)
+- Автогенерация `id` и `name` если не предоставлены
+- **Новые статические методы** (фабричные методы):
+    - `equal()`, `notEqual()`, `in()`, `notIn()`
+    - `lessThan()`, `lessOrEqual()`, `moreThan()`, `moreOrEqual()`
+
+### **AbilityRuleSet.ts**
+
+- `id` и `name` теперь опциональные
+- Добавлены статические методы:
+    - `and()` - создание группы с логическим И
+    - `or()` - создание группы с логическим ИЛИ
+
+### **AbilityPolicy.ts**
+
+- Новый метод `explain()` - получение объяснения проверки
+- Новый статический метод `parseAll()` - парсинг массива конфигураций
+- Улучшены комментарии к полю `action`
+
+### **AbilityResolver.ts**
+
+- Новый метод `resolveWithExplain()` - проверка с детальным объяснением
+- Возвращает массив `AbilityExplain[]` для анализа результатов
+
+---
+
+## Обновлена документация и примеры

package/CONTRIBUTING.md

@@ -0,0 +1,14 @@
+# Contributing to @via-profit/ability
+
+## Development Setup
+
+1. Fork the repository
+2. Install dependencies: `npm install`
+3. Build: `npm run build`
+4. Test: `npm test`
+
+## Pull Request Guidelines
+
+- Update documentation
+- Add tests for new features
+- Follow existing code style

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Via Profit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.