@lotics/cli 0.320.18 → 0.320.19
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/cli.js +19 -15
- package/docs/agent_surface.md +1 -1
- package/docs/design.md +8 -8
- package/docs/document_templates.md +1 -1
- package/package.json +1 -1
package/docs/agent_surface.md
CHANGED
|
@@ -43,7 +43,7 @@ app has.
|
|
|
43
43
|
| `<child>_by_<link>_picks` | The <child> rows no <entity> holds through "<link>" yet, that one <entity> may pick, narrowed by what the reader typed. | `search`?; `same_<link>` per `same` link | a List with `pick`: it picks existing rows into the record |
|
|
44
44
|
| `<key>` | <label>: how many <entity> rows there are. Each row carries `__count`. | the list's; `from`? / `to`? where the reading states `over`, or its `tab` is dated `in` a period; `to` where its `tab` is of rows `open` on a day | each Reading of a List's band, called by its `key` — but the work against its plan (a Reading stating `planned` and `done`), which reads the List's own rows; none over sources |
|
|
45
45
|
| `<key>` | <label>: how many <entity> rows there are. Each row carries `__count`. | `from`? / `to`? where the reading states `over` | each Reading and List of a Sheet, called by its `key` |
|
|
46
|
-
| `<key>` | <label>: how many <child> rows there are. Each row carries `__count`. | `<entity>_id`; `same_<field>` where it is a List stating `same` | each Reading of a Record page, each List that only reads on it (its `key`, else its entity's alias) and each funnel, called by its `key` |
|
|
46
|
+
| `<key>` | <label>: how many <child> rows there are. Each row carries `__count`. | `<entity>_id`; `same_<field>` where it is a List stating `same`; `record_<field>` per `where` bound to a field of the record | each Reading of a Record page, each List that only reads on it (its `key`, else its entity's alias) and each funnel, called by its `key` |
|
|
47
47
|
| `<reading>_bound` | <label> / <bound>: the sum of "<bound>" over the <entity> rows. Each row carries `__count`, `__sum`. | its reading's | a Reading whose value `records.limits` bounds: the bound's sum, beside the Reading's own |
|
|
48
48
|
| `<reading>_on_hand` | <label> / <on-hand entity>: how many <on-hand entity> rows there are, per "<field>". Each row carries `<field>`, `__count`. | none: every row of its entity its `where` keeps, whatever the place | a Reading with `on_hand` (a shortfall): the on-hand rows' groups, beside the Reading's own |
|
|
49
49
|
| `<entity>_export_rows` | Every row of <entity> the reader may see, with every field "<template>" may print. | the list's | an Export of the register that fills a template |
|
package/docs/design.md
CHANGED
|
@@ -12,9 +12,10 @@ or its entity is read-only (`edit: false`); a stepped status never is, since Act
|
|
|
12
12
|
- Each app looks like its own rows: the view its kind of row takes (`design/treatments`) — cards for things found by
|
|
13
13
|
their photo, a calendar or lanes for dated work, faces for people and organisations. A List left as a table is drawn
|
|
14
14
|
as one, the most common failure of an app; the answers of `set_app` and `get_app` note the view rows that are work in time call for (a calendar, lanes, a roster, a gantt where rows wait on one another).
|
|
15
|
-
- What needs attention leads the row
|
|
16
|
-
|
|
17
|
-
|
|
15
|
+
- What needs attention leads the row as a `Check`: a derived flag is a yes/no formula and a `Check` over it, in the warning
|
|
16
|
+
tone on the row's line (in the danger tone where its `on` refuses an act the row offers); every other yes reads in the
|
|
17
|
+
success tone. `records.mark` is a category's own mark, a select whose options carry a brand or glyph. A Check is stated
|
|
18
|
+
once, on the entity it is true of: every List over those rows offers a chip with how many hold it, and its `on` may name an Act of a record that lists them whole, through a List whose link is paired; the act holds those rows and the record first, so it cannot also send mail, notify, run an agent or wait in its own `workflow` — start that work from a workflow the act starts after.
|
|
18
19
|
- A list's columns: the name and its lead, the status, then the columns the job reads on every row, as many as fit a desk. Each
|
|
19
20
|
fact once: a column the row draws itself stands once. A generated number (`autonumber`) as the title yields
|
|
20
21
|
the row's name to the subtitle's first part and stands first on its line.
|
|
@@ -25,9 +26,8 @@ or its entity is read-only (`edit: false`); a stepped status never is, since Act
|
|
|
25
26
|
`{"kind": "avatar", "name": "person"}`, never a colour dot.
|
|
26
27
|
- A thing shows its picture, a file its preview, a plan its days on a time axis, a quantity a meter (`records.limits`) or
|
|
27
28
|
a chart, a register its Readings, and long text reads whole (a markdown Field; `block: true` on plain long text).
|
|
28
|
-
-
|
|
29
|
-
every option of a select read down a column (how it was paid, the channel).
|
|
30
|
-
means something.
|
|
29
|
+
- An option with a `color` draws its dot where its select is drawn; one without reads as its word. A `mark` where a
|
|
30
|
+
brand or glyph names the option, on every option of a select read down a column (how it was paid, the channel).
|
|
31
31
|
- Every app states its tile's `color`, apart from the workspace's other apps where it can be.
|
|
32
32
|
- The paperwork is the proof of the work: a files field per purpose (what arrived, what was issued to the customer, the
|
|
33
33
|
carrier, the authority) in the Section where that work happens, and the source of a
|
|
@@ -102,7 +102,7 @@ or its entity is read-only (`edit: false`); a stepped status never is, since Act
|
|
|
102
102
|
- `party` (`"person"` | `"organization"` | `"organisation"`): What each row is where the rows are people (a contact, a patient) or organisations (a customer, a supplier, a carrier)
|
|
103
103
|
- `limits` (map of alias → (alias | number)): A number read against a bound
|
|
104
104
|
- `starts` (map of alias → `"today"` | `"me"`): What a field of a row being added starts at, where that start is certain
|
|
105
|
-
- `mark` (alias): A single select (or a lookup of one through a one-row link)
|
|
105
|
+
- `mark` (alias): A single select (or a lookup of one through a one-row link) whose option leads the row wherever a mark leads it
|
|
106
106
|
- `settled` (alias): A yes/no of the row (stored, a formula: an invoice paid in full, or looked up through a one-row link: a line settled with its parent) that ends its deadlines
|
|
107
107
|
|
|
108
108
|
**`records.status`**
|
|
@@ -149,7 +149,7 @@ or its entity is read-only (`edit: false`); a stepped status never is, since Act
|
|
|
149
149
|
|
|
150
150
|
**Section**
|
|
151
151
|
|
|
152
|
-
- `title` (text
|
|
152
|
+
- `title` (text): The part's heading
|
|
153
153
|
- `key` (alias): Unique among its siblings
|
|
154
154
|
- `children` (list of (alias | Field | Fieldset | List | Reading | Statement | Act | Check) (at least one)): What the part draws, in reading order
|
|
155
155
|
- `at` (list of alias (at least one)): Options of the record's status during which this part is the work now
|
|
@@ -121,7 +121,7 @@ the `set_template` description for the reference; here is the capability:
|
|
|
121
121
|
- **Conditional sections** — a block shown only when a condition holds (a "paid" stamp, an
|
|
122
122
|
optional notes block). Excel/HTML/email use `{{#if}}…{{else}}…{{/if}}`; Word uses `{{IF name}}…{{END-IF name}}`.
|
|
123
123
|
|
|
124
|
-
The `html` and `email` types print a raw value through a helper in the template's `locale` (`vi` or `en`; none prints in the organization's language): `{{money total "VND"}}`, `{{number qty}}
|
|
124
|
+
The `html` and `email` types print a raw value through a helper in the template's `locale` (`vi` or `en`; none prints in the organization's language): `{{money total "VND"}}`, `{{number qty item_unit}}` (the figure, then its unit), `{{date issued_on}}`, `{{words total "USD"}}` (`reference/groups-and-templates` lists what each prints). `{{date (add_days issued_on -1)}}` prints the day before, `add_days` shifting a date by whole days. A value a helper cannot read fails the render, and a template calling a helper the engine lacks (`{{eq a b}}`) is refused when saved, naming the ones it has.
|
|
125
125
|
|
|
126
126
|
A field can also print as a **QR code** or a **Code 128 barcode** (a picture a phone's camera or a scanner reads back): `{{qr link}}` or `{{code128 position 6}}` in html (never email: mail clients do not show the picture, and a save refuses it), `{{position | qr}}` or `{{position | code128:6}}` as a whole Excel cell (its row grows to the picture), `{{IMAGE qr(position)}}` or `{{IMAGE code128(position, 6)}}` in Word. The optional number is the picture's width in centimetres. Without it the width follows the value's length — each module prints 0.5 mm in a QR code and 0.33 mm in a barcode, so a longer value prints wider; a width that would shrink a module below what a scanner reads (0.3 mm, 0.19 mm) is refused, naming the least width that scans. An empty field draws nothing.
|
|
127
127
|
|