@breadstone-infrastructure/utilities 0.0.65 → 0.0.67

package/CHANGELOG.md

@@ -0,0 +1,403 @@
+## 0.0.66 (2025-06-25)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.65 (2025-06-25)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.64 (2025-06-25)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.63 (2025-06-24)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.62 (2025-06-24)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.61 (2025-06-24)
+
+### 🚀 Features
+
+- Add formatter property to Jumbotron components and update related files ([9ae59c7ff9](https://github.com/RueDeRennes/mosaik/commit/9ae59c7ff9))
+
+## 0.0.60 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.59 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.58 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.57 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.56 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.55 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.54 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.53 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.52 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.51 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.50 (2025-06-23)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.49 (2025-06-22)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.48 (2025-06-22)
+
+### 🚀 Features
+
+- Introduce Indicator component across multiple frameworks ([7ef850c39d](https://github.com/RueDeRennes/mosaik/commit/7ef850c39d))
+
+## 0.0.47 (2025-06-22)
+
+### 🩹 Fixes
+
+- update release version to 0.0.47 in package.json ([5a277d2d1d](https://github.com/RueDeRennes/mosaik/commit/5a277d2d1d))
+- correct spelling of 'HTML' in keywords and add new article on `part` attributes ([cd5b688a5c](https://github.com/RueDeRennes/mosaik/commit/cd5b688a5c))
+- correct quotation marks in attribute selector examples for consistency ([078a6c9289](https://github.com/RueDeRennes/mosaik/commit/078a6c9289))
+- correct quotation marks in markdown article and improve blockquote rendering in MarkdownRenderer ([09442e4509](https://github.com/RueDeRennes/mosaik/commit/09442e4509))
+
+## 0.0.46 (2025-06-20)
+
+### 🚀 Features
+
+- implement animation directive and provider with presets ([09550b6633](https://github.com/RueDeRennes/mosaik/commit/09550b6633))
+
+## 0.0.45 (2025-06-20)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.44 (2025-06-20)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.43 (2025-06-20)
+
+### 🚀 Features
+
+- Add Svelte support with SvelteCodeGenerator and update build scripts ([955cb75cb6](https://github.com/RueDeRennes/mosaik/commit/955cb75cb6))
+- Add new Svelte components for menu, segment, tab, table, tree, wizard, and shell ([e6de8f0553](https://github.com/RueDeRennes/mosaik/commit/e6de8f0553))
+
+## 0.0.42 (2025-06-20)
+
+### 🩹 Fixes
+
+- update release script to version 0.0.41 ([88efd1b9ca](https://github.com/RueDeRennes/mosaik/commit/88efd1b9ca))
+
+## 0.0.41 (2025-06-19)
+
+### 🚀 Features
+
+- add comprehensive article on using const vs enums in TypeScript with Angular templates ([8db46644e3](https://github.com/RueDeRennes/mosaik/commit/8db46644e3))
+
+### 🩹 Fixes
+
+- update const vs enum article to use string literals for WorkType values ([3eb355434e](https://github.com/RueDeRennes/mosaik/commit/3eb355434e))
+- correct quotation marks in best practices section of const vs enum article ([df4187ec19](https://github.com/RueDeRennes/mosaik/commit/df4187ec19))
+- update backdrop image URLs in const vs enum article ([e05a779a0a](https://github.com/RueDeRennes/mosaik/commit/e05a779a0a))
+
+## 0.0.40 (2025-06-18)
+
+### 🚀 Features
+
+- add localizator-core dependency and update build dependencies in project configuration ([077a2cd1d9](https://github.com/RueDeRennes/mosaik/commit/077a2cd1d9))
+- enhance file system operations with path validation and update localizator plugin ([be66acdaa0](https://github.com/RueDeRennes/mosaik/commit/be66acdaa0))
+
+## 0.0.39 (2025-06-17)
+
+### 🩹 Fixes
+
+- update release version to 0.0.38 in package.json and improve description formatting in Meta.g.json ([edbd04421c](https://github.com/RueDeRennes/mosaik/commit/edbd04421c))
+
+## 0.0.38 (2025-06-17)
+
+### 🚀 Features
+
+- add comprehensive guide on the power of regions in TypeScript for improved code organization ([564b600288](https://github.com/RueDeRennes/mosaik/commit/564b600288))
+
+### 🩹 Fixes
+
+- correct formatting of region comments and quote attribution for clarity ([952d90f14b](https://github.com/RueDeRennes/mosaik/commit/952d90f14b))
+- update provideTheme function to simplify overrides and adjust merge function ([0359c488be](https://github.com/RueDeRennes/mosaik/commit/0359c488be))
+
+## 0.0.37 (2025-06-17)
+
+### 🩹 Fixes
+
+- update provideTheme to useValue for theme and mode signals ([5a7b509869](https://github.com/RueDeRennes/mosaik/commit/5a7b509869))
+
+## 0.0.35 (2025-06-17)
+
+### 🚀 Features
+
+- add theme provider for angular ([04568d1528](https://github.com/RueDeRennes/mosaik/commit/04568d1528))
+
+## 0.0.34 (2025-06-17)
+
+### 🩹 Fixes
+
+- update release script to version 0.0.33 ([0954fadfa3](https://github.com/RueDeRennes/mosaik/commit/0954fadfa3))
+
+## 0.0.33 (2025-06-16)
+
+### 🚀 Features
+
+- add 'Code' and 'TypeScript' keywords to various documentation files for improved discoverability ([7ac3c152dd](https://github.com/RueDeRennes/mosaik/commit/7ac3c152dd))
+- add "The Dependency Forest" article on dependency management challenges in Angular ([d129b84490](https://github.com/RueDeRennes/mosaik/commit/d129b84490))
+- add translation command and integrate translation functionality in BlogBaseElement ([7e166a6bea](https://github.com/RueDeRennes/mosaik/commit/7e166a6bea))
+- enhance blog and translation features with interview type and language flags ([9aff64d29b](https://github.com/RueDeRennes/mosaik/commit/9aff64d29b))
+- update interview content and add StickyController metadata in JSON ([c39d970be6](https://github.com/RueDeRennes/mosaik/commit/c39d970be6))
+- add YouTube video rendering support in MarkdownRenderer ([723610d3c8](https://github.com/RueDeRennes/mosaik/commit/723610d3c8))
+- Add new translation for "Open with" in code section ([e1b84033bc](https://github.com/RueDeRennes/mosaik/commit/e1b84033bc))
+- create Playground components for testing Markdown features ([738f61002f](https://github.com/RueDeRennes/mosaik/commit/738f61002f))
+- add PinchController for gesture recognition and enhance DiagramElement with centering functionality ([c3feb9a789](https://github.com/RueDeRennes/mosaik/commit/c3feb9a789))
+- **docs:** Update documentation with new sections, descriptions, and examples for clarity and usability ([c32ff5f976](https://github.com/RueDeRennes/mosaik/commit/c32ff5f976))
+- **docs:** Enhance MVP pattern documentation with detailed explanations and examples ([e3c97f1368](https://github.com/RueDeRennes/mosaik/commit/e3c97f1368))
+- Implement sticky positioning directive and controller, enhance scrolling functionality in Scroller class ([148f07916e](https://github.com/RueDeRennes/mosaik/commit/148f07916e))
+- Enhance MVP documentation and examples across multiple frameworks ([cfabea14a3](https://github.com/RueDeRennes/mosaik/commit/cfabea14a3))
+- add backdrop images and enhance ArticlesView with documentation grouping ([af72ff74cd](https://github.com/RueDeRennes/mosaik/commit/af72ff74cd))
+- add images and enhance Markdown documentation with improved layout and structure ([1eaac2125f](https://github.com/RueDeRennes/mosaik/commit/1eaac2125f))
+- enhance Markdown components with improved styling and layout variables ([780d383b31](https://github.com/RueDeRennes/mosaik/commit/780d383b31))
+- **markdowner:** enhance Markdown processing with new extension structure and build integration ([0c08852146](https://github.com/RueDeRennes/mosaik/commit/0c08852146))
+- Enhance Markdown processing with new features and improvements ([534983c407](https://github.com/RueDeRennes/mosaik/commit/534983c407))
+- refactor text overflow handling and enhance Markdown component styles ([62bb601fc7](https://github.com/RueDeRennes/mosaik/commit/62bb601fc7))
+- update metadata structure in documentation and improve avatar and chip components ([007bd05bea](https://github.com/RueDeRennes/mosaik/commit/007bd05bea))
+- update markdown files to use structured keywords and add author information ([d0df1b883f](https://github.com/RueDeRennes/mosaik/commit/d0df1b883f))
+
+### 🩹 Fixes
+
+- update markdowner-core dependency to use workspace reference for consistency ([518dffba42](https://github.com/RueDeRennes/mosaik/commit/518dffba42))
+- change progress/ring/bar number properties to cssLength for simpler data binding ([d15e88f0c9](https://github.com/RueDeRennes/mosaik/commit/d15e88f0c9))
+- update checkbox styles by removing unnecessary padding and border properties feat: add YouTube video embed and quote to interview markdown fix: adjust marker color in markdown styles for better visibility ([1284a2bcff](https://github.com/RueDeRennes/mosaik/commit/1284a2bcff))
+- correct quotes in interview markdown and enhance closing statements ([8d0e7134ba](https://github.com/RueDeRennes/mosaik/commit/8d0e7134ba))
+- correct formatting and update YouTube link in interview markdown ([2b430a99bc](https://github.com/RueDeRennes/mosaik/commit/2b430a99bc))
+
+## 0.0.32 (2025-06-05)
+
+### 🚀 Features
+
+- **docs): enhance keyword metadata across documentation files for improved searchability and context feat(Markdown): update MarkdownElement and MarkdownRenderer for better handling of text and code blocks fix(DocsService): refine getDocsTree method for improved documentation hierarchy and sorting fix(staticContent:** add meta information to static content registration for enhanced metadata handling ([789875e05d](https://github.com/RueDeRennes/mosaik/commit/789875e05d))
+- **build:** add vite-plugins build step to deployment script; enhance MarkdownElement and DocsService for better handling of documentation and Markdown sources ([619a32e38b](https://github.com/RueDeRennes/mosaik/commit/619a32e38b))
+- **router:** enhance routing components with role attributes and update templates for better accessibility; refactor RouterController and RouterLinkDirective for improved functionality ([63b32829f1](https://github.com/RueDeRennes/mosaik/commit/63b32829f1))
+- **router:** add RouterLinkDirective for dynamic link generation ([ab2e98ed50](https://github.com/RueDeRennes/mosaik/commit/ab2e98ed50))
+- enhance package service and controller to support history retrieval with optional limit; update translations and styles for package explorer ([71efae2557](https://github.com/RueDeRennes/mosaik/commit/71efae2557))
+- implement ShieldElement with template, style, and props; enhance package metadata and history models ([de73abbc76](https://github.com/RueDeRennes/mosaik/commit/de73abbc76))
+- enhance package service and models with metadata and history retrieval ([05c98c197d](https://github.com/RueDeRennes/mosaik/commit/05c98c197d))
+- add package manager installation step in CI workflow ([d8453719df](https://github.com/RueDeRennes/mosaik/commit/d8453719df))
+- add eslint config build step to the dev deployment workflow ([c831986474](https://github.com/RueDeRennes/mosaik/commit/c831986474))
+
+### 🩹 Fixes
+
+- **docs:** update route in command-pattern-vue.md for correct path; remove outdated mvp.requirements.md file; add comprehensive requirements documentation ([12dd351358](https://github.com/RueDeRennes/mosaik/commit/12dd351358))
+- **build:** reorder build steps in deployment script for clarity and consistency ([4e746f0b36](https://github.com/RueDeRennes/mosaik/commit/4e746f0b36))
+- update build commands in CI workflows to use 'yarn nx run' syntax ([a38e725929](https://github.com/RueDeRennes/mosaik/commit/a38e725929))
+- update description of mosaik-api in README.md for clarity ([478b4c5177](https://github.com/RueDeRennes/mosaik/commit/478b4c5177))
+- remove verbose flag from mosaik app build command ([f8f2b53714](https://github.com/RueDeRennes/mosaik/commit/f8f2b53714))
+
+## 0.0.31 (2025-05-28)
+
+### 🚀 Features
+
+- add component selector to various sample elements for better integration ([3eb465fed5](https://github.com/RueDeRennes/mosaik/commit/3eb465fed5))
+- Enhance sandbox functionality and UI improvements ([c45d7ca09b](https://github.com/RueDeRennes/mosaik/commit/c45d7ca09b))
+- Implement ProjectionController for managing projected content in portals ([1bc46717b5](https://github.com/RueDeRennes/mosaik/commit/1bc46717b5))
+- add TableFooter component and related styles ([85d9e96af5](https://github.com/RueDeRennes/mosaik/commit/85d9e96af5))
+- Refactor CheckBoxGroupSample and TextBoxSample components for improved property formatting ([b0fcc7502e](https://github.com/RueDeRennes/mosaik/commit/b0fcc7502e))
+
+### 🩹 Fixes
+
+- add missing newline at end of package.json ([713cb1f983](https://github.com/RueDeRennes/mosaik/commit/713cb1f983))
+
+## 0.0.30 (2025-05-20)
+
+### 🩹 Fixes
+
+- simplify condition checks and remove unnecessary styles in various components ([41e6b5d8a9](https://github.com/RueDeRennes/mosaik/commit/41e6b5d8a9))
+
+## 0.0.29 (2025-05-20)
+
+### 🩹 Fixes
+
+- update release script to version 0.0.28 ([baaef44d1d](https://github.com/RueDeRennes/mosaik/commit/baaef44d1d))
+
+## 0.0.28 (2025-05-20)
+
+### 🩹 Fixes
+
+- add missing newline at end of package.json ([39f2f1c578](https://github.com/RueDeRennes/mosaik/commit/39f2f1c578))
+
+## 0.0.27 (2025-05-20)
+
+### 🚀 Features
+
+- add default values for boolean attributes across various components ([899d593ba5](https://github.com/RueDeRennes/mosaik/commit/899d593ba5))
+- update release script to version 0.0.26 ([11e2fdbc4f](https://github.com/RueDeRennes/mosaik/commit/11e2fdbc4f))
+
+### 🩹 Fixes
+
+- update TabStrip and TreeItem styles to handle disabled state correctly ([ecb60798db](https://github.com/RueDeRennes/mosaik/commit/ecb60798db))
+
+## 0.0.26 (2025-05-19)
+
+### 🚀 Features
+
+- update release script to version 0.0.25 ([930ba60eb4](https://github.com/RueDeRennes/mosaik/commit/930ba60eb4))
+
+## 0.0.25 (2025-05-19)
+
+### 🚀 Features
+
+- update version to 0.0.24 and remove prefix/suffix styles from various components ([d061c7f8cd](https://github.com/RueDeRennes/mosaik/commit/d061c7f8cd))
+
+## 0.0.24 (2025-05-19)
+
+### 🚀 Features
+
+- update appearance of input components and add textAlign property ([5f7321b7a8](https://github.com/RueDeRennes/mosaik/commit/5f7321b7a8))
+
+## 0.0.23 (2025-05-19)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.22 (2025-05-18)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.21 (2025-05-18)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.20 (2025-05-18)
+
+### 🩹 Fixes
+
+- update release version to 0.0.19 in package.json ([acccb56f76](https://github.com/RueDeRennes/mosaik/commit/acccb56f76))
+
+## 0.0.19 (2025-05-18)
+
+### 🩹 Fixes
+
+- add missing newline at end of package.json ([43ce0e6a3b](https://github.com/RueDeRennes/mosaik/commit/43ce0e6a3b))
+
+## 0.0.18 (2025-05-18)
+
+### 🩹 Fixes
+
+- correct spelling of 'getScrollableElement' and remove unused method ([72e17ecc7a](https://github.com/RueDeRennes/mosaik/commit/72e17ecc7a))
+
+## 0.0.17 (2025-05-18)
+
+### 🚀 Features
+
+- add Invalidable behavior and validity check to components ([893bb30b3b](https://github.com/RueDeRennes/mosaik/commit/893bb30b3b))
+
+## 0.0.16 (2025-05-17)
+
+### 🩹 Fixes
+
+- correct spelling of 'success' in logSummary parameter documentation chore: update release script version to 0.0.16 chore: add 'keyhandle' to cspell words ([1a9d5e8732](https://github.com/RueDeRennes/mosaik/commit/1a9d5e8732))
+
+## 0.0.15 (2025-05-16)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.14 (2025-05-16)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.13 (2025-05-16)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.13 (2025-05-16)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.12 (2025-05-16)
+
+This was a version bump only for utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.11 (2025-05-13)
+
+### 🚀 Features
+
+- **eslint:** add TypeScript ESLint configuration with comprehensive ruleset ([4d7a0d88b7](https://github.com/RueDeRennes/mosaik/commit/4d7a0d88b7))
+- Add Insetable behavior and update BoxElement styles ([ca740ab5f2](https://github.com/RueDeRennes/mosaik/commit/ca740ab5f2))
+- add exports field to package.json and implement transformExports function ([99f3fbe3f1](https://github.com/RueDeRennes/mosaik/commit/99f3fbe3f1))
+
+### 🩹 Fixes
+
+- correct spelling errors in README and update release version in package.json ([922364afec](https://github.com/RueDeRennes/mosaik/commit/922364afec))
+- different themes and styles ([917e55212d](https://github.com/RueDeRennes/mosaik/commit/917e55212d))
+- add missing words to cSpell configuration ([933dd56139](https://github.com/RueDeRennes/mosaik/commit/933dd56139))
+- correct spelling errors and improve property names in interfaces and components ([e7edf69f3e](https://github.com/RueDeRennes/mosaik/commit/e7edf69f3e))
+
+## 0.0.12-beta.9 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.8 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.7 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.6 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.5 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.3 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.1 (2025-05-07)
+
+This was a version bump only for infra-utilities to align it with other projects, there were no code changes.
+
+## 0.0.12-beta.0 (2025-05-07)
+
+### 🚀 Features
+
+- enhance project configurations with inputs and outputs for build targets ([6f80d15bda](https://github.com/RueDeRennes/mosaik/commit/6f80d15bda))
+
+## 0.0.2-beta.0 (2025-05-06)
+
+### 🚀 Features
+
+- enhance project configurations with inputs and outputs for build targets ([6f80d15bda](https://github.com/RueDeRennes/mosaik/commit/6f80d15bda))

package/README.md

@@ -0,0 +1,139 @@
+# @breadstone-infrastructure/utilities
+
+**Common utility classes and functions for Breadstone projects.**
+This package provides a rich set of utilities for CLI programs, file system operations, logging, dependency injection, and more.
+It is designed for use in Node.js/TypeScript monorepos and is part of the Breadstone Nx workspace.
+
+---
+
+## Features
+
+- **CLI Framework**: Build robust CLI tools with argument parsing, command registration, and configuration.
+- **File System Utilities**: High-level APIs for files, directories, globs, JSON, RESX, templates, and more.
+- **Logging**: Flexible logger with colorized output, log levels, appenders, and advanced formatting.
+- **Dependency Injection**: Lightweight DI container for modular, testable code.
+- **System Utilities**: Helpers for strings, arrays, numbers, guards, formatting, and more.
+- **TypeScript-first**: Fully typed, modern codebase.
+- **Nx Workspace**: Built for scalable, maintainable monorepo development.
+
+---
+
+## Installation
+
+```sh
+yarn add @breadstone-infrastructure/utilities
+# or
+npm install @breadstone-infrastructure/utilities
+```
+
+---
+
+## Usage
+
+Import and use utilities in your TypeScript/Node.js projects:
+
+```ts
+import { Program, Logger, File, Directory, Path, ConsoleLogger } from '@breadstone-infrastructure/utilities';
+
+// CLI Example
+class MyCli extends Program {
+  // ...
+}
+
+// Logging Example
+Logger.configure({ isDebug: true });
+Logger.instance().logInfo('Hello, world!');
+
+// File System Example
+const files = File.glob('src/**/*.ts');
+const content = File.readAllText(files[0]);
+```
+
+---
+
+## API Overview
+
+### CLI
+
+- `Program` – Abstract base for CLI programs.
+- `ProgramBuilder` – Fluent builder for CLI programs.
+- `ProgramCommandBase` – Base class for CLI commands.
+- Argument and command interfaces for strong typing.
+
+### File System
+
+- `File`, `Directory`, `Path` – High-level file and directory operations.
+- `Json`, `Resx`, `Template` – Parse and generate JSON, RESX, and template files.
+- `FileSystem`, `FileCache` – Abstracted file system and caching (vNext).
+- `TemporaryFile`, `TemporaryDirectory` – Easy temp file/dir management.
+
+### Logging
+
+- `Logger` – Configurable logger with log levels, color, and appenders.
+- `ConsoleLogger` – Simple console logger (vNext).
+- `LoggerUtils` – Helpers for logging trees, summaries, etc.
+- `logSeparator`, `logTree`, `logTag`, `logSummary`, `logPair`, `logTask`, `logBanner` – Advanced log formatting.
+
+### Dependency Injection
+
+- `Container` – DI container for registering and resolving dependencies.
+- `inject` – Helper for dependency injection.
+
+### System Utilities
+
+- `StringExtensions`, `ArrayExtensions`, `AssignExtensions`, `Boolean`, `Formatter`, `Guard`, etc.
+
+---
+
+## Example: CLI Program
+
+```ts
+import { Program, ProgramCommandBase } from '@breadstone-infrastructure/utilities';
+
+class HelloCommand extends ProgramCommandBase {
+  get name() { return 'hello'; }
+  get args() { return []; }
+  async execute() {
+    console.log('Hello from CLI!');
+    return { canceled: false, result: undefined };
+  }
+}
+
+class MyCli extends Program {
+  constructor() {
+    super({ description: 'My CLI' });
+    this.commands.register('hello', HelloCommand);
+  }
+}
+
+new MyCli().init().then(cli => cli.run());
+```
+
+---
+
+## Nx Workspace
+
+This package is part of the Breadstone Nx monorepo.
+Use Nx for building, testing, and managing dependencies:
+
+```sh
+npx nx run utilities:build
+npx nx run utilities:test
+```
+
+---
+
+## Development
+
+- Written in TypeScript.
+- Linting: `yarn lint`
+- Testing: `yarn test`
+- Build: `yarn build`
+
+---
+
+## License
+
+MIT © Breadstone
+
+---

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@breadstone-infrastructure/utilities",
     "description": "Common utility classes and functions",
-    "version": "0.0.65",
+    "version": "0.0.67",
     "license": "MIT",
     "author": "andre.wehlert <awehlert@breadstone.de> (https://www.breadstone.de)",
     "repository": {
@@ -15,7 +15,7 @@
     "dependencies": {
         "argparse": "^2.0.1",
         "dir-glob": "^3.0.1",
-        "es-toolkit": "^1.39.4",
+        "es-toolkit": "^1.39.5",
         "fast-glob": "^3.3.3",
         "fs-extra": "^11.3.0",
         "jsonc-parser": "^3.3.1",