@twin.org/cli-core 0.0.2-next.8 → 0.0.2

package/docs/examples.md

@@ -1 +1,82 @@
-# @twin.org/cli-core - Examples
+# CLI Core Examples
+
+Use these snippets to compose clear command line workflows with consistent output, argument parsing and file handling.
+
+## CLIDisplay
+
+```typescript
+import { CLIDisplay } from '@twin.org/cli-core';
+
+CLIDisplay.header('Data Import', '1.2.0');
+CLIDisplay.section('Validation');
+CLIDisplay.value('Records', 128);
+CLIDisplay.warning('2 rows have missing optional fields');
+CLIDisplay.done();
+```
+
+## CLIParam
+
+```typescript
+import { CLIParam } from '@twin.org/cli-core';
+
+const parsedCount = CLIParam.integer('count', '25');
+const parsedDebug = CLIParam.boolean('debug', 'true');
+const parsedUrl = CLIParam.url('endpoint', 'https://api.example.org');
+
+console.log(parsedCount + 1); // 26
+console.log(parsedDebug); // true
+console.log(parsedUrl.host); // api.example.org
+```
+
+## CLIBase
+
+```typescript
+import { CLIBase } from '@twin.org/cli-core';
+import type { Command } from 'commander';
+
+class ToolCli extends CLIBase {
+  protected getCommands(program: Command): Command[] {
+    return [program.command('status').action(() => {})];
+  }
+}
+
+const cli = new ToolCli();
+const exitCode = await cli.execute(
+  {
+    appName: 'tool-cli',
+    title: 'Tool CLI',
+    version: '1.0.0'
+  },
+  './locales',
+  ['node', 'tool-cli', 'status']
+);
+
+console.log(exitCode); // 0
+```
+
+## CLIUtils
+
+```typescript
+import { CLIUtils } from '@twin.org/cli-core';
+
+console.log(await CLIUtils.fileExists('./config/import.json')); // true
+const config = await CLIUtils.readJsonFile<{ source: string }>('./config/import.json');
+await CLIUtils.writeEnvFile('./dist/import.env', {
+  SOURCE: config.source
+});
+console.log(config.source); // ./data/source.json
+```
+
+## CLIOptions
+
+```typescript
+import { CLIOptions } from '@twin.org/cli-core';
+
+const options = new CLIOptions();
+
+options.output({
+  json: './dist/output.json'
+});
+
+console.log(options.toObject().json); // ./dist/output.json
+```

package/docs/reference/classes/CLIBase.md

@@ -14,7 +14,7 @@ The main entry point for the CLI.
 
 ## Methods
 
-### execute()
+### execute() {#execute}
 
 > **execute**(`options`, `localesDirectory`, `argv`): `Promise`\<`number`\>
 
@@ -48,7 +48,7 @@ The exit code.
 
 ***
 
-### configureRoot()
+### configureRoot() {#configureroot}
 
 > `protected` **configureRoot**(`program`): `void`
 
@@ -68,7 +68,7 @@ The root program command.
 
 ***
 
-### getCommands()
+### getCommands() {#getcommands}
 
 > `protected` **getCommands**(`program`): `Command`[]
 

package/docs/reference/classes/CLIDisplay.md

@@ -14,7 +14,7 @@ Display utilities for the CLI.
 
 ## Properties
 
-### write()
+### write {#write}
 
 > `static` **write**: (`buffer`) => `void`
 
@@ -24,9 +24,9 @@ The default output method for writing standard messages.
 
 ##### buffer
 
-The message to output.
+`string` \| `Uint8Array`\<`ArrayBufferLike`\>
 
-`string` | `Uint8Array`\<`ArrayBufferLike`\>
+The message to output.
 
 #### Returns
 
@@ -34,7 +34,7 @@ The message to output.
 
 ***
 
-### writeError()
+### writeError {#writeerror}
 
 > `static` **writeError**: (`buffer`) => `void`
 
@@ -44,9 +44,9 @@ The default output method for writing error messages.
 
 ##### buffer
 
-The message to output.
+`string` \| `Uint8Array`\<`ArrayBufferLike`\>
 
-`string` | `Uint8Array`\<`ArrayBufferLike`\>
+The message to output.
 
 #### Returns
 
@@ -54,7 +54,7 @@ The message to output.
 
 ***
 
-### clearLine()
+### clearLine {#clearline}
 
 > `static` **clearLine**: () => `void`
 
@@ -66,7 +66,7 @@ The default output method for clearing the current line.
 
 ## Methods
 
-### header()
+### header() {#header}
 
 > `static` **header**(`title`, `version`, `icon`): `void`
 
@@ -98,9 +98,9 @@ The icon for the CLI.
 
 ***
 
-### error()
+### error() {#error}
 
-> `static` **error**(`error`, `lineBreaks`): `void`
+> `static` **error**(`error`, `lineBreaks?`): `void`
 
 Display an error message.
 
@@ -112,7 +112,7 @@ Display an error message.
 
 The error to display.
 
-##### lineBreaks
+##### lineBreaks?
 
 `boolean` = `true`
 
@@ -124,7 +124,27 @@ Whether to add a line break after the error.
 
 ***
 
-### section()
+### errorMessage() {#errormessage}
+
+> `static` **errorMessage**(`error`): `void`
+
+Display an error message in simple form.
+
+#### Parameters
+
+##### error
+
+`string`
+
+The error to display.
+
+#### Returns
+
+`void`
+
+***
+
+### section() {#section}
 
 > `static` **section**(`label`): `void`
 
@@ -144,9 +164,9 @@ The label for the section.
 
 ***
 
-### value()
+### value() {#value}
 
-> `static` **value**(`label`, `value`, `indentLevel`): `void`
+> `static` **value**(`label`, `value`, `indentLevel?`): `void`
 
 Display a value with a label.
 
@@ -164,7 +184,7 @@ The label for the value.
 
 The value to display.
 
-##### indentLevel
+##### indentLevel?
 
 `number` = `0`
 
@@ -176,7 +196,7 @@ The level of indentation.
 
 ***
 
-### task()
+### task() {#task}
 
 > `static` **task**(`label`, `task?`): `void`
 
@@ -202,7 +222,7 @@ The task to display.
 
 ***
 
-### break()
+### break() {#break}
 
 > `static` **break**(): `void`
 
@@ -214,7 +234,7 @@ Display a break.
 
 ***
 
-### json()
+### json() {#json}
 
 > `static` **json**(`obj`): `void`
 
@@ -234,7 +254,7 @@ The object to display.
 
 ***
 
-### warning()
+### warning() {#warning}
 
 > `static` **warning**(`label`): `void`
 
@@ -254,7 +274,7 @@ The label for the warning.
 
 ***
 
-### done()
+### done() {#done}
 
 > `static` **done**(): `void`
 
@@ -266,27 +286,27 @@ Display the processing is done.
 
 ***
 
-### spinnerStart()
+### spinnerStart() {#spinnerstart}
 
-> `static` **spinnerStart**(`i18nMessage`, `spinnerCharacters`, `interval`): `void`
+> `static` **spinnerStart**(`i18nMessage?`, `spinnerCharacters?`, `interval?`): `void`
 
 Start the spinner.
 
 #### Parameters
 
-##### i18nMessage
+##### i18nMessage?
 
 `string` = `"cli.progress.pleaseWait"`
 
 The message to display with the spinner.
 
-##### spinnerCharacters
+##### spinnerCharacters?
 
 `string`[] = `...`
 
 The characters to use in the spinner.
 
-##### interval
+##### interval?
 
 `number` = `100`
 
@@ -298,7 +318,7 @@ The interval for the spinner.
 
 ***
 
-### spinnerStop()
+### spinnerStop() {#spinnerstop}
 
 > `static` **spinnerStop**(): `void`
 

package/docs/reference/classes/CLIOptions.md

@@ -14,7 +14,7 @@ Utilities for getting standard options.
 
 ## Methods
 
-### output()
+### output() {#output}
 
 > `static` **output**(`command`, `opts`): `void`