inray 0.0.3 → 0.0.5

package/LICENSE.md

@@ -18,33 +18,34 @@ PERFORMANCE OF THIS SOFTWARE.
 
 Additional Functionality and integrated external libraries:
 
-| Library name                                                                                                                              | Author                                                |                                        License                                        | Version\*        | Modification level\*\* | Internal name\*\*\* |
-| :---------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- | :-----------------------------------------------------------------------------------: | :--------------- | ---------------------- | ------------------- |
-| [valibot](https://valibot.dev/)                                                                                                           | [Fabian Hiller](https://github.com/fabian-hiller)     |                            [MIT](./src/valibot/LICENSE.md)                            | **1.4.2**        | Zero or low            | same                |
-| [@valibot/i18n](https://github.com/open-circle/valibot/tree/main/packages/i18n)                                                           | [Fabian Hiller](https://github.com/fabian-hiller)     |                         [MIT](./src/valibot/i18n/LICENSE.md)                          | **1.2.0**        | Zero or low            | same                |
-| [@valibot/to-json-schema](https://github.com/open-circle/valibot/tree/main/packages/to-json-schema)                                       | [Fabian Hiller](https://github.com/fabian-hiller)     |                    [MIT](./src/valibot/to-json-schema/LICENSE.md)                     | **1.7.1**        | Zero                   | same                |
-| [node-cron](https://www.nodecron.com/)                                                                                                    | [Lucas Merencia](https://github.com/merencia)         |                           [ISC](./src/node-cron/LICENSE.md)                           | **4.6.0**        | Zero or low            | same                |
-| [yaml](https://eemeli.org/yaml/#yaml)                                                                                                     | [Eemeli Aro](https://github.com/eemeli)               |                             [ISC](./src/yaml/LICENSE.md)                              | **3.0.0-1 (RC)** | Zero or low            | same                |
-| [@std/async](https://jsr.io/@std/async)                                                                                                   | [Deno authors](https://github.com/denoland)           |                             [MIT](./src/async/LICENSE.md)                             | **1.5.0**        | Zero or low            | same as domain      |
-| [@std/bytes](https://jsr.io/@std/bytes)                                                                                                   | [Deno authors](https://github.com/denoland)           |                             [MIT](./src/bytes/LICENSE.md)                             | **1.0.6**        | Zero or low            | same as domain      |
-| [@std/collections](https://jsr.io/@std/collections)                                                                                       | [Deno authors](https://github.com/denoland)           |                          [MIT](./src/collections/LICENSE.md)                          | **1.3.0**        | Zero or low            | same as domain      |
-| [@std/csv](https://jsr.io/@std/csv)                                                                                                       | [Deno authors](https://github.com/denoland)           |                              [MIT](./src/csv/LICENSE.md)                              | **1.0.6**        | Low                    | same as domain      |
-| [@std/data-structures](https://jsr.io/@std/data-structures)                                                                               | [Deno authors](https://github.com/denoland)           |                        [MIT](./src/data-structures/LICENSE.md)                        | **1.1.1**        | Zero or low            | same as domain      |
-| [@std/encoding](https://jsr.io/@std/encoding)                                                                                             | [Deno authors](https://github.com/denoland)           |                           [MIT](./src/encoding/LICENSE.md)                            | **1.0.11**       | Low                    | same as domain      |
-| [@std/fmt](https://jsr.io/@std/fmt)                                                                                                       | [Deno authors](https://github.com/denoland)           |                              [MIT](./src/fmt/LICENSE.md)                              | **1.0.10**       | Low                    | same as domain      |
-| [@std/json](https://jsr.io/@std/json)                                                                                                     | [Deno authors](https://github.com/denoland)           |                             [MIT](./src/json/LICENSE.md)                              | **1.1.0**        | Low                    | same as domain      |
-| [@std/jsonc](https://jsr.io/@std/jsonc)                                                                                                   | [Deno authors](https://github.com/denoland)           |                             [MIT](./src/jsonc/LICENSE.md)                             | **1.0.2**        | Zero or low            | same as domain      |
-| [@std/media-types](https://jsr.io/@std/media-types)                                                                                       | [Deno authors](https://github.com/denoland)           |                          [MIT](./src/media_types/LICENSE.md)                          | **1.1.0**        | Zero or low            | same as domain      |
-| [@std/streams](https://jsr.io/@std/streams)                                                                                               | [Deno authors](https://github.com/denoland)           |                            [MIT](./src/streams/LICENSE.md)                            | **1.1.1**        | Low                    | same as domain      |
-| [jose](https://github.com/panva/jose)                                                                                                     | [Filip Skokan](https://github.com/panva)              |                             [MIT](./src/jose/LICENSE.md)                              | **6.2.8**        | Zero or low            | same                |
-| [date-fns](https://date-fns.org/)                                                                                                         | [Sasha Koss](https://github.com/kossnocorp)           |                         [MIT](./src/date-fns/core/LICENSE.md)                         | **4.4.0**        | Zero or low            | same                |
-| [unidecode](https://github.com/FGRibreau/node-unidecode)                                                                                  | [Francois-Guillaume Ribreau](https://fgribreau.com)   |                           [BSD](./src/unidecode/LICENSE.md)                           | **1.1.0**        | Average                | same                |
-| [libphonenumber-js](https://gitlab.com/catamphetamine/libphonenumber-js)                                                                  | [Nikolay Kuchumov](https://gitlab.com/catamphetamine) | [MIT](./src/phonenumbers/LICENSE.md), [Apache](./src/phonenumbers//LICENSE.Apache.md) | **1.13.11**      | High                   | phonenumbers        |
-| [logtape](https://logtape.org/) and parts: <br> @logtape/config, @logtape/file, <br> @logtape/pretty, @logtape/redaction, @logtape/syslog | [Hong Minhee (洪 民憙)](https://github.com/dahlia)    |                            [MIT](./src/logtape/LICENSE.md)                            | **2.3.2**        | Zero or low            | same                |
-| [postgres.js](https://github.com/porsager/postgres/tree/master)                                                                           | [Rasmus Porsager](https://github.com/porsager)        |                      [UNLICENSE](./src/db/postgres/UNLICENSE.md)                      | **3.4.9**        | Zero                   | same                |
-| [hono](https://hono.dev/)                                                                                                                 | [Yusuke Wada](https://github.com/yusukebe)            |                             [MIT](./src/hono/LICENSE.md)                              | **4.13.5**       | Low                    | same                |
-| [@hono/node-server](https://github.com/honojs/node-server)                                                                                | [Yusuke Wada](https://github.com/yusukebe)            |                       [MIT](./src/hono/node-server/LICENSE.md)                        | **2.1.1**        | Zero or low            | same                |
-| [cache-manager](https://cacheable.org/docs/cache-manager/) and parts: keyv, @keyv/serialize, @cacheable/utils, hashery, hookified         | [Jared Wray](https://github.com/jaredwray)            |           [MIT](<./src/caching/LICENSE%20(cache-manager%20and%20parts).md>)           | **7.2.9**        | Average                | caching             |
+| Library name                                                                                                                              | Author                                                                                 |                                        License                                        | Version\*        | Modification level\*\* | Internal name\*\*\* |
+| :---------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :-----------------------------------------------------------------------------------: | :--------------- | ---------------------- | ------------------- |
+| [valibot](https://valibot.dev/)                                                                                                           | [Fabian Hiller](https://github.com/fabian-hiller)                                      |                            [MIT](./src/valibot/LICENSE.md)                            | **1.4.2**        | Zero or low            | same                |
+| [@valibot/i18n](https://github.com/open-circle/valibot/tree/main/packages/i18n)                                                           | [Fabian Hiller](https://github.com/fabian-hiller)                                      |                         [MIT](./src/valibot/i18n/LICENSE.md)                          | **1.2.0**        | Zero or low            | same                |
+| [@valibot/to-json-schema](https://github.com/open-circle/valibot/tree/main/packages/to-json-schema)                                       | [Fabian Hiller](https://github.com/fabian-hiller)                                      |                    [MIT](./src/valibot/to-json-schema/LICENSE.md)                     | **1.7.1**        | Zero                   | same                |
+| [node-cron](https://www.nodecron.com/)                                                                                                    | [Lucas Merencia](https://github.com/merencia)                                          |                           [ISC](./src/node-cron/LICENSE.md)                           | **4.6.0**        | Zero or low            | same                |
+| [yaml](https://eemeli.org/yaml/#yaml)                                                                                                     | [Eemeli Aro](https://github.com/eemeli)                                                |                             [ISC](./src/yaml/LICENSE.md)                              | **3.0.0-1 (RC)** | Zero or low            | same                |
+| [@std/async](https://jsr.io/@std/async)                                                                                                   | [Deno authors](https://github.com/denoland)                                            |                             [MIT](./src/async/LICENSE.md)                             | **1.5.0**        | Zero or low            | same as domain      |
+| [@std/bytes](https://jsr.io/@std/bytes)                                                                                                   | [Deno authors](https://github.com/denoland)                                            |                             [MIT](./src/bytes/LICENSE.md)                             | **1.0.6**        | Zero or low            | same as domain      |
+| [@std/collections](https://jsr.io/@std/collections)                                                                                       | [Deno authors](https://github.com/denoland)                                            |                          [MIT](./src/collections/LICENSE.md)                          | **1.3.0**        | Zero or low            | same as domain      |
+| [@std/csv](https://jsr.io/@std/csv)                                                                                                       | [Deno authors](https://github.com/denoland)                                            |                              [MIT](./src/csv/LICENSE.md)                              | **1.0.6**        | Low                    | same as domain      |
+| [@std/data-structures](https://jsr.io/@std/data-structures)                                                                               | [Deno authors](https://github.com/denoland)                                            |                        [MIT](./src/data-structures/LICENSE.md)                        | **1.1.1**        | Zero or low            | same as domain      |
+| [@std/encoding](https://jsr.io/@std/encoding)                                                                                             | [Deno authors](https://github.com/denoland)                                            |                           [MIT](./src/encoding/LICENSE.md)                            | **1.0.11**       | Low                    | same as domain      |
+| [@std/fmt](https://jsr.io/@std/fmt)                                                                                                       | [Deno authors](https://github.com/denoland)                                            |                              [MIT](./src/fmt/LICENSE.md)                              | **1.0.10**       | Low                    | same as domain      |
+| [@std/json](https://jsr.io/@std/json)                                                                                                     | [Deno authors](https://github.com/denoland)                                            |                             [MIT](./src/json/LICENSE.md)                              | **1.1.0**        | Low                    | same as domain      |
+| [@std/jsonc](https://jsr.io/@std/jsonc)                                                                                                   | [Deno authors](https://github.com/denoland)                                            |                             [MIT](./src/jsonc/LICENSE.md)                             | **1.0.2**        | Zero or low            | same as domain      |
+| [@std/media-types](https://jsr.io/@std/media-types)                                                                                       | [Deno authors](https://github.com/denoland)                                            |                          [MIT](./src/media_types/LICENSE.md)                          | **1.1.0**        | Zero or low            | same as domain      |
+| [@std/streams](https://jsr.io/@std/streams)                                                                                               | [Deno authors](https://github.com/denoland)                                            |                            [MIT](./src/streams/LICENSE.md)                            | **1.1.1**        | Low                    | same as domain      |
+| [jose](https://github.com/panva/jose)                                                                                                     | [Filip Skokan](https://github.com/panva)                                               |                             [MIT](./src/jose/LICENSE.md)                              | **6.2.8**        | Zero or low            | same                |
+| [date-fns](https://date-fns.org/)                                                                                                         | [Sasha Koss](https://github.com/kossnocorp)                                            |                         [MIT](./src/date-fns/core/LICENSE.md)                         | **4.4.0**        | Zero or low            | same                |
+| [unidecode](https://github.com/FGRibreau/node-unidecode)                                                                                  | [Francois-Guillaume Ribreau](https://fgribreau.com)                                    |                           [BSD](./src/unidecode/LICENSE.md)                           | **1.1.0**        | Average                | same                |
+| [libphonenumber-js](https://gitlab.com/catamphetamine/libphonenumber-js)                                                                  | [Nikolay Kuchumov](https://gitlab.com/catamphetamine)                                  | [MIT](./src/phonenumbers/LICENSE.md), [Apache](./src/phonenumbers//LICENSE.Apache.md) | **1.13.11**      | High                   | phonenumbers        |
+| [logtape](https://logtape.org/) and parts: <br> @logtape/config, @logtape/file, <br> @logtape/pretty, @logtape/redaction, @logtape/syslog | [Hong Minhee (洪 民憙)](https://github.com/dahlia)                                     |                            [MIT](./src/logtape/LICENSE.md)                            | **2.3.2**        | Zero or low            | same                |
+| [postgres.js](https://github.com/porsager/postgres/tree/master)                                                                           | [Rasmus Porsager](https://github.com/porsager)                                         |                      [UNLICENSE](./src/db/postgres/UNLICENSE.md)                      | **3.4.9**        | Zero                   | same                |
+| [hono](https://hono.dev/)                                                                                                                 | [Yusuke Wada](https://github.com/yusukebe)                                             |                             [MIT](./src/hono/LICENSE.md)                              | **4.13.5**       | Low                    | same                |
+| [@hono/node-server](https://github.com/honojs/node-server)                                                                                | [Yusuke Wada](https://github.com/yusukebe)                                             |                       [MIT](./src/hono/node-server/LICENSE.md)                        | **2.1.1**        | Zero or low            | same                |
+| [cache-manager](https://cacheable.org/docs/cache-manager/) and parts: keyv, @keyv/serialize, @cacheable/utils, hashery, hookified         | [Jared Wray](https://github.com/jaredwray)                                             |           [MIT](<./src/caching/LICENSE%20(cache-manager%20and%20parts).md>)           | **7.2.9**        | Average                | caching             |
+| [commander.js](https://github.com/tj/commander.js)                                                                                        | [TJ Holowaychuk](https://github.com/tj)<br> [John Gee](https://github.com/shadowspawn) |                              [MIT](./src/cli/LICENSE.md)                              | **15.0.0**       | Average                | cli                 |
 
 \* - integrated version of library
 

package/README.md

@@ -1,5 +1,6 @@
 Inray - all-in-one инструментарий для разработки **Node.js** приложений
-🚧🚧🚧 under heavy development / в активной разработке 🚧🚧🚧
+
+🚧⚠️🛠️ Under heavy development / В активной разработке 🚧⚠️🛠️
 
 ## Оглавление
 
@@ -7,8 +8,7 @@ Inray - all-in-one инструментарий для разработки **No
 - [Причины и особенности реализации](#причины-и-особенности-реализации)
 - [Текущий состав SDK](#текущий-состав-sdk)
 - [Обновления и версионирование](#обновления-и-версионирование)
-- [Документация](#документация)
-- [Пример использования](#пример-использования)
+- [Документация](#документация-и-примеры-использования)
 - [Совместимость c Runtime](#совместимость-c-runtime)
 - [Лицензирование](#лицензирование)
 - [Благодарность](#благодарность)
@@ -64,34 +64,53 @@ Inray - all-in-one инструментарий для разработки **No
 
 <span style="color:red">I</span> - _"Поставка в составе SDK"_, исходная библиотека поставляется как есть
 
-<span style="color:green">II</span> - _"Первичная интеграция"_, библиотека приводится под единый TypeScript конфиг + тесты переводится на Vitest (всё одинаковое в рамках SDK). Функционал по возможности остаётся как есть
+<span style="color:green">II</span> - _"Первичная интеграция"_, библиотека приводится под единый TypeScript конфиг + тесты переводится на единую конфигурацию Vitest (всё одинаковое в рамках SDK). Функционал по возможности остаётся как есть
 
 <span style="color:blue">III</span> - _"Рефакторинг" (форк)_, дублирующий API, по отношению к SDK - вычищается, библиотека начинает использовать инструментарий из SDK
 
 <span style="color:purple">IV</span> - "Внедрение", остальные части SDK обновляются и используют новую интегрированную часть, то есть обеспечивается консистентность
 
-| Логический домен / область применения                       | Домен (inray/\*)                    |         Уровень интеграции*         | Исходные библиотеки                                                                                                                                                                            | Комментарий       |
-| :---------------------------------------------------------- | :---------------------------------- | :---------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- |
-| Вспомогательные асинхронные функции                         | /async                              | <span style="color:green">II</span> | [@std/async](https://jsr.io/@std/async/doc)                                                                                                                                                    | In progress 🛠️... |
-| Работа с байтами                                            | /bytes                              | <span style="color:green">II</span> | [@std/bytes](https://jsr.io/@std/bytes/doc)                                                                                                                                                    |                   |
-| Работа с потоками (stream)                                  | /streams                            | <span style="color:green">II</span> | [@std/streams](https://jsr.io/@std/streams/doc)                                                                                                                                                |                   |
-| Коллекции и структуры данных                                | /collections и<br> /data-structures | <span style="color:green">II</span> | [@std/collections](https://jsr.io/@std/collections/doc) <br> [@std/data-structures](https://jsr.io/@std/data-structures/doc)                                                                   |                   |
-| Кодирование, декодирование, форматирование и транслитерация | /encoding и<br> /unidecode          | <span style="color:green">II</span> | [@std/encoding](https://jsr.io/@std/encoding/doc) <br> [@std/fmt](https://jsr.io/@std/fmt/doc/all_symbols?no_default_entrypoint) <br> [unidecode](https://github.com/FGRibreau/node-unidecode) |                   |
-| Работа с датами и временем                                  | /date-fns                           | <span style="color:green">II</span> | [date-fns](https://date-fns.org/v4.4.0/docs/Getting-Started)                                                                                                                                   |                   |
-| Логирование                                                 | /logtape                            | <span style="color:green">II</span> | [logtape (и его части)](https://logtape.org/)                                                                                                                                                  |                   |
-| Обработка файлов распространенных форматов                  | /json, /jsonc, /csv, /yaml          | <span style="color:green">II</span> | [@std/json](https://jsr.io/@std/json/doc) <br> [@std/jsonc](https://jsr.io/@std/jsonc/doc) <br> [@std/csv](https://jsr.io/@std/csv/doc) <br> [yaml](https://eemeli.org/yaml/#yaml)             |                   |
-| Обработка MIME-типов                                        | /media-types                        | <span style="color:green">II</span> | [@std/media-types](https://jsr.io/@std/media-types/doc)                                                                                                                                        |                   |
-| Задачи по расписанию                                        | /node-cron                          | <span style="color:green">II</span> | [node-cron](https://www.nodecron.com/)                                                                                                                                                         |                   |
-| Валидация                                                   | /valibot                            | <span style="color:green">II</span> | [valibot (и его части)](https://valibot.dev/)                                                                                                                                                  |                   |
-| Драйверы к базам данных                                     | /db/postgres                        |  <span style="color:red">I</span>   | [postgres.js](https://github.com/porsager/postgres/tree/master)                                                                                                                                |                   |
-| Криптографические функции                                   | /jose                               | <span style="color:green">II</span> | [jose](https://github.com/panva/jose)                                                                                                                                                          |                   |
-| Работа с телефонными номерами                               | /phonenumbers                       | <span style="color:blue">III</span> | [libphonenumber-js](https://gitlab.com/catamphetamine/libphonenumber-js)                                                                                                                       |                   |
-| Основной серверный фреймворк                                | /hono                               | <span style="color:green">II</span> | [hono](https://hono.dev/docs/)                                                                                                                                                                 |                   |
-| Общие инструменты                                           | /utils                              | <span style="color:blue">III</span> | -                                                                                                                                                                                              |                   |
-| Кеширование                                                 | /caching                            | <span style="color:blue">III</span> | [cache-manager (и его части)](https://cacheable.org/)                                                                                                                                          |                   |
+| Логический домен / область применения                             | Домен (inray/\*)                    |         Уровень интеграции*         | Исходные библиотеки                                                                                                                                                                            | Комментарий       |
+| :---------------------------------------------------------------- | :---------------------------------- | :---------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------------- |
+| Вспомогательные асинхронные функции                               | /async                              | <span style="color:green">II</span> | [@std/async](https://jsr.io/@std/async/doc)                                                                                                                                                    | In progress 🛠️... |
+| Работа с байтами                                                  | /bytes                              | <span style="color:green">II</span> | [@std/bytes](https://jsr.io/@std/bytes/doc)                                                                                                                                                    |                   |
+| Работа с потоками (stream)                                        | /streams                            | <span style="color:green">II</span> | [@std/streams](https://jsr.io/@std/streams/doc)                                                                                                                                                |                   |
+| Коллекции и структуры данных                                      | /collections и<br> /data-structures | <span style="color:green">II</span> | [@std/collections](https://jsr.io/@std/collections/doc) <br> [@std/data-structures](https://jsr.io/@std/data-structures/doc)                                                                   |                   |
+| Кодирование, декодирование, форматирование и транслитерация       | /encoding и<br> /unidecode          | <span style="color:green">II</span> | [@std/encoding](https://jsr.io/@std/encoding/doc) <br> [@std/fmt](https://jsr.io/@std/fmt/doc/all_symbols?no_default_entrypoint) <br> [unidecode](https://github.com/FGRibreau/node-unidecode) |                   |
+| Работа с датами и временем                                        | /date-fns                           | <span style="color:green">II</span> | [date-fns](https://date-fns.org/v4.4.0/docs/Getting-Started)                                                                                                                                   |                   |
+| Логирование                                                       | /logtape                            | <span style="color:green">II</span> | [logtape (и его части)](https://logtape.org/)                                                                                                                                                  |                   |
+| Обработка файлов распространенных форматов                        | /json, /jsonc, /csv, /yaml          | <span style="color:green">II</span> | [@std/json](https://jsr.io/@std/json/doc) <br> [@std/jsonc](https://jsr.io/@std/jsonc/doc) <br> [@std/csv](https://jsr.io/@std/csv/doc) <br> [yaml](https://eemeli.org/yaml/#yaml)             |                   |
+| Обработка MIME-типов                                              | /media-types                        | <span style="color:green">II</span> | [@std/media-types](https://jsr.io/@std/media-types/doc)                                                                                                                                        |                   |
+| Задачи по расписанию                                              | /node-cron                          | <span style="color:green">II</span> | [node-cron](https://www.nodecron.com/)                                                                                                                                                         |                   |
+| Валидация                                                         | /valibot                            | <span style="color:green">II</span> | [valibot (и его части)](https://valibot.dev/)                                                                                                                                                  |                   |
+| Драйверы к базам данных                                           | /db/postgres                        |  <span style="color:red">I</span>   | [postgres.js](https://github.com/porsager/postgres/tree/master)                                                                                                                                |                   |
+| Криптографические функции                                         | /jose                               | <span style="color:green">II</span> | [jose](https://github.com/panva/jose)                                                                                                                                                          |                   |
+| Работа с телефонными номерами                                     | /phonenumbers                       | <span style="color:blue">III</span> | [libphonenumber-js](https://gitlab.com/catamphetamine/libphonenumber-js)                                                                                                                       |                   |
+| Основной серверный фреймворк                                      | /hono                               | <span style="color:green">II</span> | [hono](https://hono.dev/docs/)                                                                                                                                                                 |                   |
+| Различные инструменты и вспомогательные функции общего назначения | /utils                              | <span style="color:blue">III</span> | -                                                                                                                                                                                              |                   |
+| Кеширование                                                       | /caching                            | <span style="color:blue">III</span> | [cache-manager (и его части)](https://cacheable.org/)                                                                                                                                          |                   |
+| Обработка аргументов командной строки (CLI)                       | /cli                                | <span style="color:green">II</span> | [commander.js](https://github.com/tj/commander.js)                                                                                                                                             |                   |
 
 \* _уровень может отображать как итог, так и процесс_
 
+🚧⚠️🛠️ ROADMAP дальнейших интеграций 🚧⚠️🛠️:
+
+- мигратор (для различных драйверов БД) 🛠️...
+- iconv (работа с кодировками) 🛠️...
+- tedious (драйвер для работы с MS SQL Server) 🛠️...
+- redis/valkey (кеширование) 🛠️...
+- S3 (для работы с AWS, MiniO, RustFS и т.д.) 🛠️...
+- kafka 🛠️...
+- nodemailer либо upyo (для работы с SMTP/IMAP)
+- amqp (для работы с RabbitMQ)
+- ws и работа с сокетами
+- graphql + dataloader (говорит само за себя)
+- rpc (пока не определено конкретно)
+- RxJS (мета, реактивность, под вопросом интеграции)
+- fp-ts (мета, функциональная парадигма, под вопросом интеграции)
+- await-to-js (мета, go-подобный стиль, под вопросом интеграции)
+- immer (гарантии иммутабельности, под вопросом интеграции)
+
 ## Обновления и версионирование
 
 In progress 🛠️...
@@ -100,11 +119,95 @@ In progress 🛠️...
 
 In progress 🛠️...
 
-## Документация
+## Документация и примеры использования
+
+In progress 🛠️...
+
+### inray/async - асинхронные функции
+
+In progress 🛠️...
+
+### inray/bytes - работа с байтами
+
+In progress 🛠️...
+
+### inray/caching - кеширование
+
+In progress 🛠️...
+
+### inray/collections - коллекции и вспомогательные функции для работы с итерируемыми объектами
+
+In progress 🛠️...
+
+### inray/csv - работа с CSV-файлами
+
+In progress 🛠️...
+
+### inray/data-structures - обобщенные структуры данных
+
+In progress 🛠️...
+
+### inray/date-fns - работа с датой и временем
+
+In progress 🛠️...
+
+### inray/db, inray/db/postgres - работа с БД
+
+In progress 🛠️...
+
+### inray/encoding - кодирование и декодирование данных
+
+In progress 🛠️...
+
+### inray/fmt/bytes, inray/fmt/colors, inray/fmt/duration - функции строкового представления различных данных
+
+In progress 🛠️...
+
+### inray/hono - веб-фреймворк Hono и его части
+
+In progress 🛠️...
+
+### inray/jose - набор криптографический функций в рамках библиотеки jose
+
+In progress 🛠️...
+
+### inray/json - дополнительные хелперы для работы с JSON
+
+In progress 🛠️...
+
+### inray/jsonc - парсинг JSONC файлов
+
+In progress 🛠️...
+
+### inray/logtape - логгер logtape и его части
+
+In progress 🛠️...
+
+### inray/media-types - работа с "content-type" и MIME
+
+In progress 🛠️...
+
+### inray/node-cron - задачи по расписанию в рамках библиотеки node-cron
+
+In progress 🛠️...
+
+### inray/phonenumbers - парсинг и валидация телефонных номеров
+
+In progress 🛠️...
+
+### inray/streams - работа с потоками (Stream)
+
+In progress 🛠️...
+
+### inray/unidecode - транслитерация строк
+
+In progress 🛠️...
+
+### inray/utils - вспомогательные функции, классы, типы и валидаторы общего назначения
 
 In progress 🛠️...
 
-## Пример использования
+### inray/yaml - работа с YAML-файлами в рамках библиотеки yaml
 
 In progress 🛠️...
 
@@ -140,33 +243,34 @@ PERFORMANCE OF THIS SOFTWARE.
 
 Integrated and modified external libraries:
 
-| Library name                                                                                                                              | Author                                                |   License   | Version\*        | Modification level\*\* | Internal name\*\*\* |
-| :---------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------- | :---------: | :--------------- | ---------------------- | ------------------- |
-| [valibot](https://valibot.dev/)                                                                                                           | [Fabian Hiller](https://github.com/fabian-hiller)     |     MIT     | **1.4.2**        | Zero or low            | same                |
-| [@valibot/i18n](https://github.com/open-circle/valibot/tree/main/packages/i18n)                                                           | [Fabian Hiller](https://github.com/fabian-hiller)     |     MIT     | **1.2.0**        | Zero or low            | same                |
-| [@valibot/to-json-schema](https://github.com/open-circle/valibot/tree/main/packages/to-json-schema)                                       | [Fabian Hiller](https://github.com/fabian-hiller)     |     MIT     | **1.7.1**        | Zero                   | same                |
-| [node-cron](https://www.nodecron.com/)                                                                                                    | [Lucas Merencia](https://github.com/merencia)         |     ISC     | **4.6.0**        | Zero or low            | same                |
-| [yaml](https://eemeli.org/yaml/#yaml)                                                                                                     | [Eemeli Aro](https://github.com/eemeli)               |     ISC     | **3.0.0-1 (RC)** | Zero or low            | same                |
-| [@std/async](https://jsr.io/@std/async)                                                                                                   | [Deno authors](https://github.com/denoland)           |     MIT     | **1.5.0**        | Zero or low            | same as domain      |
-| [@std/bytes](https://jsr.io/@std/bytes)                                                                                                   | [Deno authors](https://github.com/denoland)           |     MIT     | **1.0.6**        | Zero or low            | same as domain      |
-| [@std/collections](https://jsr.io/@std/collections)                                                                                       | [Deno authors](https://github.com/denoland)           |     MIT     | **1.3.0**        | Zero or low            | same as domain      |
-| [@std/csv](https://jsr.io/@std/csv)                                                                                                       | [Deno authors](https://github.com/denoland)           |     MIT     | **1.0.6**        | Low                    | same as domain      |
-| [@std/data-structures](https://jsr.io/@std/data-structures)                                                                               | [Deno authors](https://github.com/denoland)           |     MIT     | **1.1.1**        | Zero or low            | same as domain      |
-| [@std/encoding](https://jsr.io/@std/encoding)                                                                                             | [Deno authors](https://github.com/denoland)           |     MIT     | **1.0.11**       | Low                    | same as domain      |
-| [@std/fmt](https://jsr.io/@std/fmt)                                                                                                       | [Deno authors](https://github.com/denoland)           |     MIT     | **1.0.10**       | Low                    | same as domain      |
-| [@std/json](https://jsr.io/@std/json)                                                                                                     | [Deno authors](https://github.com/denoland)           |     MIT     | **1.1.0**        | Low                    | same as domain      |
-| [@std/jsonc](https://jsr.io/@std/jsonc)                                                                                                   | [Deno authors](https://github.com/denoland)           |     MIT     | **1.0.2**        | Zero or low            | same as domain      |
-| [@std/media-types](https://jsr.io/@std/media-types)                                                                                       | [Deno authors](https://github.com/denoland)           |     MIT     | **1.1.0**        | Zero or low            | same as domain      |
-| [@std/streams](https://jsr.io/@std/streams)                                                                                               | [Deno authors](https://github.com/denoland)           |     MIT     | **1.1.1**        | Low                    | same as domain      |
-| [jose](https://github.com/panva/jose)                                                                                                     | [Filip Skokan](https://github.com/panva)              |     MIT     | **6.2.8**        | Zero or low            | same                |
-| [date-fns](https://date-fns.org/)                                                                                                         | [Sasha Koss](https://github.com/kossnocorp)           |     MIT     | **4.4.0**        | Zero or low            | same                |
-| [unidecode](https://github.com/FGRibreau/node-unidecode)                                                                                  | [Francois-Guillaume Ribreau](https://fgribreau.com)   |     BSD     | **1.1.0**        | Average                | same                |
-| [libphonenumber-js](https://gitlab.com/catamphetamine/libphonenumber-js)                                                                  | [Nikolay Kuchumov](https://gitlab.com/catamphetamine) | MIT, Apache | **1.13.11**      | High                   | phonenumbers        |
-| [logtape](https://logtape.org/) and parts: <br> @logtape/config, @logtape/file, <br> @logtape/pretty, @logtape/redaction, @logtape/syslog | [Hong Minhee (洪 民憙)](https://github.com/dahlia)    |     MIT     | **2.3.2**        | Zero or low            | same                |
-| [postgres.js](https://github.com/porsager/postgres/tree/master)                                                                           | [Rasmus Porsager](https://github.com/porsager)        |  UNLICENSE  | **3.4.9**        | Zero                   | same                |
-| [hono](https://hono.dev/)                                                                                                                 | [Yusuke Wada](https://github.com/yusukebe)            |     MIT     | **4.13.5**       | Low                    | same                |
-| [@hono/node-server](https://github.com/honojs/node-server)                                                                                | [Yusuke Wada](https://github.com/yusukebe)            |     MIT     | **2.1.1**        | Zero or low            | same                |
-| [cache-manager](https://cacheable.org/docs/cache-manager/) and parts: keyv, @keyv/serialize, @cacheable/utils, hashery, hookified         | [Jared Wray](https://github.com/jaredwray)            |     MIT     | **7.2.9**        | Average                | caching             |
+| Library name                                                                                                                              | Author                                                                                 |           License           | Version\*        | Modification level\*\* | Internal name\*\*\* |
+| :---------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------- | :-------------------------: | :--------------- | ---------------------- | ------------------- |
+| [valibot](https://valibot.dev/)                                                                                                           | [Fabian Hiller](https://github.com/fabian-hiller)                                      |             MIT             | **1.4.2**        | Zero or low            | same                |
+| [@valibot/i18n](https://github.com/open-circle/valibot/tree/main/packages/i18n)                                                           | [Fabian Hiller](https://github.com/fabian-hiller)                                      |             MIT             | **1.2.0**        | Zero or low            | same                |
+| [@valibot/to-json-schema](https://github.com/open-circle/valibot/tree/main/packages/to-json-schema)                                       | [Fabian Hiller](https://github.com/fabian-hiller)                                      |             MIT             | **1.7.1**        | Zero                   | same                |
+| [node-cron](https://www.nodecron.com/)                                                                                                    | [Lucas Merencia](https://github.com/merencia)                                          |             ISC             | **4.6.0**        | Zero or low            | same                |
+| [yaml](https://eemeli.org/yaml/#yaml)                                                                                                     | [Eemeli Aro](https://github.com/eemeli)                                                |             ISC             | **3.0.0-1 (RC)** | Zero or low            | same                |
+| [@std/async](https://jsr.io/@std/async)                                                                                                   | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.5.0**        | Zero or low            | same as domain      |
+| [@std/bytes](https://jsr.io/@std/bytes)                                                                                                   | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.0.6**        | Zero or low            | same as domain      |
+| [@std/collections](https://jsr.io/@std/collections)                                                                                       | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.3.0**        | Zero or low            | same as domain      |
+| [@std/csv](https://jsr.io/@std/csv)                                                                                                       | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.0.6**        | Low                    | same as domain      |
+| [@std/data-structures](https://jsr.io/@std/data-structures)                                                                               | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.1.1**        | Zero or low            | same as domain      |
+| [@std/encoding](https://jsr.io/@std/encoding)                                                                                             | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.0.11**       | Low                    | same as domain      |
+| [@std/fmt](https://jsr.io/@std/fmt)                                                                                                       | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.0.10**       | Low                    | same as domain      |
+| [@std/json](https://jsr.io/@std/json)                                                                                                     | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.1.0**        | Low                    | same as domain      |
+| [@std/jsonc](https://jsr.io/@std/jsonc)                                                                                                   | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.0.2**        | Zero or low            | same as domain      |
+| [@std/media-types](https://jsr.io/@std/media-types)                                                                                       | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.1.0**        | Zero or low            | same as domain      |
+| [@std/streams](https://jsr.io/@std/streams)                                                                                               | [Deno authors](https://github.com/denoland)                                            |             MIT             | **1.1.1**        | Low                    | same as domain      |
+| [jose](https://github.com/panva/jose)                                                                                                     | [Filip Skokan](https://github.com/panva)                                               |             MIT             | **6.2.8**        | Zero or low            | same                |
+| [date-fns](https://date-fns.org/)                                                                                                         | [Sasha Koss](https://github.com/kossnocorp)                                            |             MIT             | **4.4.0**        | Zero or low            | same                |
+| [unidecode](https://github.com/FGRibreau/node-unidecode)                                                                                  | [Francois-Guillaume Ribreau](https://fgribreau.com)                                    |             BSD             | **1.1.0**        | Average                | same                |
+| [libphonenumber-js](https://gitlab.com/catamphetamine/libphonenumber-js)                                                                  | [Nikolay Kuchumov](https://gitlab.com/catamphetamine)                                  |         MIT, Apache         | **1.13.11**      | High                   | phonenumbers        |
+| [logtape](https://logtape.org/) and parts: <br> @logtape/config, @logtape/file, <br> @logtape/pretty, @logtape/redaction, @logtape/syslog | [Hong Minhee (洪 民憙)](https://github.com/dahlia)                                     |             MIT             | **2.3.2**        | Zero or low            | same                |
+| [postgres.js](https://github.com/porsager/postgres/tree/master)                                                                           | [Rasmus Porsager](https://github.com/porsager)                                         |          UNLICENSE          | **3.4.9**        | Zero                   | same                |
+| [hono](https://hono.dev/)                                                                                                                 | [Yusuke Wada](https://github.com/yusukebe)                                             |             MIT             | **4.13.5**       | Low                    | same                |
+| [@hono/node-server](https://github.com/honojs/node-server)                                                                                | [Yusuke Wada](https://github.com/yusukebe)                                             |             MIT             | **2.1.1**        | Zero or low            | same                |
+| [cache-manager](https://cacheable.org/docs/cache-manager/) and parts: keyv, @keyv/serialize, @cacheable/utils, hashery, hookified         | [Jared Wray](https://github.com/jaredwray)                                             |             MIT             | **7.2.9**        | Average                | caching             |
+| [commander.js](https://github.com/tj/commander.js)                                                                                        | [TJ Holowaychuk](https://github.com/tj)<br> [John Gee](https://github.com/shadowspawn) | [MIT](./src/cli/LICENSE.md) | **15.0.0**       | Average                | cli                 |
 
 \* - integrated version of library
 
@@ -217,3 +321,5 @@ However, sometimes integrated libraries change their original name for one or mo
 - [Tomas Zijdemans](https://github.com/tomas-zijdemans)
 - [Rasmus Porsager](https://github.com/porsager)
 - [Jared Wray](https://github.com/jaredwray)
+- [TJ Holowaychuk](https://github.com/tj)
+- [John Gee](https://github.com/shadowspawn)

package/dist/async/abortable.d.ts

@@ -17,7 +17,7 @@
  * @returns A promise that can be aborted.
  *
  * @example Error-handling a timeout
- * ```ts ignore
+ * ```ts
  * import { abortable, delay } from "inray/async";
  *
  * const promise = delay(1_000);
@@ -31,7 +31,7 @@
  * ```
  *
  * @example Error-handling an abort
- * ```ts ignore
+ * ```ts
  * import { abortable, delay } from "inray/async";
  *
  * const promise = delay(1_000);

package/dist/async/abortable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abortable.d.ts","sourceRoot":"","sources":["../../src/async/abortable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAKL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"abortable.d.ts","sourceRoot":"","sources":["../../src/async/abortable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AAIL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC"}

package/dist/async/abortable.js.map

@@ -1 +1 @@
-{"version":3,"file":"abortable.js","sourceRoot":"","sources":["../../src/async/abortable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AA8FL,MAAM,UAAU,SAAS,CAAI,CAAgC,EAAE,MAAmB;IAChF,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC;QACzB,OAAO,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,sBAAsB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAI,CAAa,EAAE,MAAmB;IAC7D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC3D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,EAAE,CAAC;IAC5B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QAC7C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAAI,CAAmB,EAAE,MAAmB;IAChF,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC3D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;gBACd,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC;YACnC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,MAAM,EAAE,KAAK,CAAC;YACvB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}
+{"version":3,"file":"abortable.js","sourceRoot":"","sources":["../../src/async/abortable.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,KAAK;AA4FL,MAAM,UAAU,SAAS,CAAI,CAAgC,EAAE,MAAmB;IAChF,IAAI,CAAC,YAAY,OAAO,EAAE,CAAC;QACzB,OAAO,gBAAgB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,sBAAsB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAI,CAAa,EAAE,MAAmB;IAC7D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC3D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,EAAE,CAAC;IAC5B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QAC7C,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,sBAAsB,CAAI,CAAmB,EAAE,MAAmB;IAChF,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAS,CAAC;IAC3D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAExD,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;gBACd,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC,CAAC,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC;YACnC,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,MAAM,EAAE,KAAK,CAAC;YACvB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/dist/cli/mod.d.ts

@@ -0,0 +1,2 @@
+export * from './src/index.ts';
+//# sourceMappingURL=mod.d.ts.map

package/dist/cli/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../src/cli/mod.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/cli/mod.js

@@ -0,0 +1,2 @@
+export * from "./src/index.js";
+//# sourceMappingURL=mod.js.map

package/dist/cli/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/cli/mod.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/cli/src/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { Argument } from './lib/argument.ts';
+import { Command } from './lib/command.ts';
+import { CommanderError, InvalidArgumentError } from './lib/error.ts';
+import { Help } from './lib/help.ts';
+import { Option } from './lib/option.ts';
+export declare const program: Command;
+export declare const createCommand: (name: string) => Command;
+export declare const createOption: (flags: string, description?: string) => Option;
+export declare const createArgument: (name: string, description?: string) => Argument;
+/**
+ * Expose classes
+ */
+export { Command, Option, Argument, Help };
+export { CommanderError, InvalidArgumentError };
+export { InvalidArgumentError as InvalidOptionArgumentError };
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAEL,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,eAAO,MAAM,OAAO,SAAgB,CAAC;AAErC,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,YAAsB,CAAC;AACjE,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,EAAE,cAAc,MAAM,WAAmC,CAAC;AACpG,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,cAAc,MAAM,aAAoC,CAAC;AAEtG;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,CAAC;AAChD,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,CAAC"}

package/dist/cli/src/index.js

@@ -0,0 +1,25 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { Argument } from "./lib/argument.js";
+import { Command } from "./lib/command.js";
+import { CommanderError, InvalidArgumentError } from "./lib/error.js";
+import { Help } from "./lib/help.js";
+import { Option } from "./lib/option.js";
+export const program = new Command();
+export const createCommand = (name) => new Command(name);
+export const createOption = (flags, description) => new Option(flags, description);
+export const createArgument = (name, description) => new Argument(name, description);
+/**
+ * Expose classes
+ */
+export { Command, Option, Argument, Help };
+export { CommanderError, InvalidArgumentError };
+export { InvalidArgumentError as InvalidOptionArgumentError }; // Deprecated
+//# sourceMappingURL=index.js.map

package/dist/cli/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAEL,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,WAAoB,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AACpG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,WAAoB,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;AAEtG;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,CAAC;AAChD,OAAO,EAAE,oBAAoB,IAAI,0BAA0B,EAAE,CAAC,CAAC,aAAa"}

package/dist/cli/src/lib/argument.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+export type ArgumentParseFunction = (value: string, previous: any) => any;
+export declare class Argument {
+    description: string;
+    required: boolean;
+    variadic: boolean;
+    defaultValue?: any;
+    defaultValueDescription?: string;
+    parseArg?: ArgumentParseFunction;
+    argChoices?: string[];
+    _name: string;
+    /**
+     * Initialize a new command argument with the given name and description.
+     * The default is that the argument is required, and you can explicitly
+     * indicate this with <> around the name. Put [] around the name for an optional argument.
+     *
+     * @param {string} name
+     * @param {string} [description]
+     */
+    constructor(name: string, description?: string);
+    /**
+     * Return argument name.
+     *
+     * @return {string}
+     */
+    name(): string;
+    /**
+     * @package
+     */
+    _collectValue(value: any, previous: any): any;
+    /**
+     * Set the default value, and optionally supply the description to be displayed in the help.
+     *
+     * @param {*} value
+     * @param {string} [description]
+     * @return {Argument}
+     */
+    default(value: unknown, description?: string): this;
+    /**
+     * Set the custom handler for processing CLI command arguments into argument values.
+     *
+     * @param {Function} [fn]
+     * @return {Argument}
+     */
+    argParser(fn: ArgumentParseFunction): this;
+    /**
+     * Only allow argument value to be one of choices.
+     *
+     * @param {string[]} values
+     * @return {Argument}
+     */
+    choices(values: readonly string[]): this;
+    /**
+     * Make argument required.
+     *
+     * @returns {Argument}
+     */
+    argRequired(): this;
+    /**
+     * Make argument optional.
+     *
+     * @returns {Argument}
+     */
+    argOptional(): this;
+}
+/**
+ * Takes an argument and returns its human readable equivalent for help usage.
+ *
+ * @param {Argument} arg
+ * @return {string}
+ * @private
+ */
+export declare function humanReadableArgName(arg: Argument): string;
+//# sourceMappingURL=argument.d.ts.map

package/dist/cli/src/lib/argument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument.d.ts","sourceRoot":"","sources":["../../../../src/cli/src/lib/argument.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAIL,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,GAAG,CAAC;AAE1E,qBAAa,QAAQ;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;OAOG;gBACS,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IA6B9C;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,GAAG,GAAG;IAS7C;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI;IAK1C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAcxC;;;;OAIG;IACH,WAAW;IAKX;;;;OAIG;IACH,WAAW;CAIZ;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAI1D"}