@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.
@@ -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: `records.mark` on a select or a computed category (a formula stating its options;
16
- where it is empty, its seat is blank). A yes that needs attention (papers still owed) is a `Check` of its List over a
17
- yes/no formula, in the warning tone on the row's line; every other yes reads in the success tone.
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
- - Every category the job reads is coloured: each option's `color`, and a `mark` where a brand or glyph names it, on
29
- every option of a select read down a column (how it was paid, the channel). Colour an option only where the colour
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), or a formula that states its options, whose option leads the row wherever a mark leads it
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, required): The part's heading
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}}`, `{{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.
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
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lotics/cli",
3
- "version": "0.320.18",
3
+ "version": "0.320.19",
4
4
  "description": "Lotics SDK and CLI for AI agents",
5
5
  "type": "module",
6
6
  "bin": {