e30ae8ed09
- App.tsx: full navigation (Auth stack + Main tabs with 5 screens) - Auth: LoginScreen, RegisterScreen, ForgotPasswordScreen - HomeScreen: dashboard with IoT metrics, weather widget, alerts, quick actions, sensors - MapScreen: interactive map with layer toggles (6 layers) - MarketplaceScreen: categories (6), products (5), search - ChatScreen: AI chat with quick prompts (4), bot responses - ProfileScreen: user info, stats, menu (9 items), logout - AlertsScreen: alert list with severity, acknowledge - SensorsScreen: sensor list with type filters (6 types), search - ZonesScreen: zone cards with stats - SettingsScreen: language picker (FR/EN/ES/DE), privacy, about - Stores: iotStore (sensors, zones, alerts), notificationStore, uiStore + i18n - Hooks: useSensors, useAlerts, useNotifications, useLocation - Components: Card, Button, LoadingSpinner, ErrorBoundary, Header - Services: iotService, notificationService (with axios API client) - Utils: formatters (temp, AQI, noise, dates), validators (email, password, IBAN) - Theme: colors.ts with full design system (Blue Ocean palette) - Ditto: fixed MongoDB connection, new JWT secrets, official gateway image
142 lines
2.9 KiB
Markdown
142 lines
2.9 KiB
Markdown
# cliui
|
|
|
|
|
|
[](https://www.npmjs.com/package/cliui)
|
|
[](https://conventionalcommits.org)
|
|
|
|
|
|
easily create complex multi-column command-line-interfaces.
|
|
|
|
## Example
|
|
|
|
```js
|
|
const ui = require('cliui')()
|
|
|
|
ui.div('Usage: $0 [command] [options]')
|
|
|
|
ui.div({
|
|
text: 'Options:',
|
|
padding: [2, 0, 1, 0]
|
|
})
|
|
|
|
ui.div(
|
|
{
|
|
text: "-f, --file",
|
|
width: 20,
|
|
padding: [0, 4, 0, 4]
|
|
},
|
|
{
|
|
text: "the file to load." +
|
|
chalk.green("(if this description is long it wraps).")
|
|
,
|
|
width: 20
|
|
},
|
|
{
|
|
text: chalk.red("[required]"),
|
|
align: 'right'
|
|
}
|
|
)
|
|
|
|
console.log(ui.toString())
|
|
```
|
|
|
|
## Deno/ESM Support
|
|
|
|
As of `v7` `cliui` supports [Deno](https://github.com/denoland/deno) and
|
|
[ESM](https://nodejs.org/api/esm.html#esm_ecmascript_modules):
|
|
|
|
```typescript
|
|
import cliui from "https://deno.land/x/cliui/deno.ts";
|
|
|
|
const ui = cliui({})
|
|
|
|
ui.div('Usage: $0 [command] [options]')
|
|
|
|
ui.div({
|
|
text: 'Options:',
|
|
padding: [2, 0, 1, 0]
|
|
})
|
|
|
|
ui.div({
|
|
text: "-f, --file",
|
|
width: 20,
|
|
padding: [0, 4, 0, 4]
|
|
})
|
|
|
|
console.log(ui.toString())
|
|
```
|
|
|
|
<img width="500" src="screenshot.png">
|
|
|
|
## Layout DSL
|
|
|
|
cliui exposes a simple layout DSL:
|
|
|
|
If you create a single `ui.div`, passing a string rather than an
|
|
object:
|
|
|
|
* `\n`: characters will be interpreted as new rows.
|
|
* `\t`: characters will be interpreted as new columns.
|
|
* `\s`: characters will be interpreted as padding.
|
|
|
|
**as an example...**
|
|
|
|
```js
|
|
var ui = require('./')({
|
|
width: 60
|
|
})
|
|
|
|
ui.div(
|
|
'Usage: node ./bin/foo.js\n' +
|
|
' <regex>\t provide a regex\n' +
|
|
' <glob>\t provide a glob\t [required]'
|
|
)
|
|
|
|
console.log(ui.toString())
|
|
```
|
|
|
|
**will output:**
|
|
|
|
```shell
|
|
Usage: node ./bin/foo.js
|
|
<regex> provide a regex
|
|
<glob> provide a glob [required]
|
|
```
|
|
|
|
## Methods
|
|
|
|
```js
|
|
cliui = require('cliui')
|
|
```
|
|
|
|
### cliui({width: integer})
|
|
|
|
Specify the maximum width of the UI being generated.
|
|
If no width is provided, cliui will try to get the current window's width and use it, and if that doesn't work, width will be set to `80`.
|
|
|
|
### cliui({wrap: boolean})
|
|
|
|
Enable or disable the wrapping of text in a column.
|
|
|
|
### cliui.div(column, column, column)
|
|
|
|
Create a row with any number of columns, a column
|
|
can either be a string, or an object with the following
|
|
options:
|
|
|
|
* **text:** some text to place in the column.
|
|
* **width:** the width of a column.
|
|
* **align:** alignment, `right` or `center`.
|
|
* **padding:** `[top, right, bottom, left]`.
|
|
* **border:** should a border be placed around the div?
|
|
|
|
### cliui.span(column, column, column)
|
|
|
|
Similar to `div`, except the next row will be appended without
|
|
a new line being created.
|
|
|
|
### cliui.resetOutput()
|
|
|
|
Resets the UI elements of the current cliui instance, maintaining the values
|
|
set for `width` and `wrap`.
|