@lotics/cli 0.320.7 → 0.320.9

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.
@@ -78,7 +78,6 @@ the screen already holds.
78
78
  | `<entity>_pictures` | The picture and name of each <entity> row among the ids handed in. | `<entity>_ids` | a link to several pictured rows |
79
79
  | `<entity>_count_by_<scope>` | How many <entity> rows each <scope entity> holds. | | an app stating `scope` |
80
80
  | `<task>_progress_by_<link>` | How many <task> rows each <entity> row handed in holds, at each status. | `<entity>_ids` | rows whose task rows are counted done |
81
- | `<child>_nested_by_<link>` | The <child> rows under any <entity> handed in, through "<link>". | `<entity>_ids` | each plain List of child rows on the page of rows a List holds open by `nested`, for the rows it draws; named as that List's read under one record, `_nested` after the child |
82
81
  | `<entity>_sub_counts_by_<link>` | How many <entity> rows stand under each <entity> row handed in, through <link>, at each status. | `<entity>_ids` | a record's rows block over a hierarchy (`nests`), for the rows it draws |
83
82
  | `<entity>_plan_places` | Every <place> the <entity> rows stand at, with what the plan draws of each. | | a register laid out as a `plan`: the places its rows stand at |
84
83
  | `<lane>_lanes` | The <lane> rows of one <scope entity>, each a lane of the board. | `<scope entity>_id` | a lanes board inside an app stating `scope` |
package/docs/design.md CHANGED
@@ -230,7 +230,7 @@ Each kind of row's view is chosen before its List is written:
230
230
  | A day's work given out to people or vehicles | List `layout: {"lanes": {"by": …}}` over rows holding a day and no hour | `reference/lanes` |
231
231
  | A log of what happened | a child List with `layout: "timeline"` | `reference/layouts` |
232
232
  | Opened to be worked on | the Record's Sections — each one area of the record's data, its lists and field groups inside it; a status's stage acts stand at the foot of the rows they move, `at` where the work moves in steps; fields only one kind of row holds (a delay's cause, a safety issue's hours lost) in a Section whose `when` names that kind | |
233
- | Rows that each belong to another row | a child List on that row's Record, with `create` and `remove` — and a child's own rows a List in that child's page, as deep as the data goes; `nested: true` on the List stands every row open on those child Lists, so a line and its sources read as one sheet, and every row's ⋯ offers Duplicate; a List with `same` where read-only | |
233
+ | Rows that each belong to another row | a child List on that row's Record, with `create` and `remove` — and a child's own rows a List in that child's page, as deep as the data goes, and every row's ⋯ offers Duplicate; a List with `same` where read-only | |
234
234
  | A related row's value on the list (the newest contract's end date) | a `lookup` field of the table, ordered, as a column | `reference/lookup` |
235
235
  | Moving through a status | an Act per move, `status.dates` for the moment of each stage, and the register's Readings | |
236
236
  | Counted over a period | the register's Tabs over one `period`; a Tab's `totals` for a child's sums before, during and through it; an open Tab's `where` reads only what was true at the period's end, never a status the row moves on from | |
package/docs/examples.md CHANGED
@@ -1452,99 +1452,6 @@ among them: the `design` reference. Every key: `reference`, at the pages each se
1452
1452
  }
1453
1453
  ```
1454
1454
 
1455
- ## Lines and sources
1456
-
1457
- **The job.** Fill each line of an order from several suppliers, editing a line and what each supplier sends on one page, as in a spreadsheet.
1458
-
1459
- **Read.** A child List stating `nested`: each line stands open on the List its own page holds (the sources), written in place; a line's ⋯ duplicates it.
1460
-
1461
- **Keys.** `reference/list-node`
1462
-
1463
- **Not when.** Rows whose own children are read one row at a time, or grouped by a link instead (`group`): open them one at a time.
1464
-
1465
- ```json
1466
- {
1467
- "tables": [
1468
- {
1469
- "ref": "don_hang",
1470
- "title": "so_don",
1471
- "fields": {
1472
- "so_don": {"type": "text"},
1473
- "khach_hang": {"type": "link", "table": "khach_hang", "multi": false},
1474
- "ngay_giao": {"type": "date"},
1475
- "trang_thai": {
1476
- "type": "select",
1477
- "options": [
1478
- {"alias": "moi", "color": "blue"},
1479
- {"alias": "da_dat", "color": "amber"},
1480
- {"alias": "da_giao", "color": "green"}
1481
- ]
1482
- }
1483
- },
1484
- "records": {"subtitle": ["khach_hang", "ngay_giao"], "status": {"field": "trang_thai"}}
1485
- },
1486
- {
1487
- "ref": "dong_don",
1488
- "title": "mat_hang",
1489
- "fields": {
1490
- "don_hang": {"type": "link", "table": "don_hang", "multi": false},
1491
- "mat_hang": {"type": "link", "table": "mat_hang", "multi": false},
1492
- "so_luong": {"type": "number"},
1493
- "da_dat": {"type": "rollup"},
1494
- "nguon": {"type": "link", "table": "nguon", "multi": true}
1495
- },
1496
- "records": {"figure": "so_luong"}
1497
- }
1498
- ],
1499
- "body": {
1500
- "type": "App",
1501
- "key": "don_hang",
1502
- "name": "Đơn hàng",
1503
- "icon": "shopping-cart",
1504
- "color": "green",
1505
- "children": [
1506
- {
1507
- "type": "List",
1508
- "entity": "don_hang",
1509
- "columns": ["ngay_giao"],
1510
- "filters": ["trang_thai"],
1511
- "search": ["so_don", "khach_hang"],
1512
- "sort": {"field": "ngay_giao", "desc": true}
1513
- }
1514
- ],
1515
- "pages": [
1516
- {
1517
- "type": "Record",
1518
- "entity": "don_hang",
1519
- "children": [
1520
- {
1521
- "type": "Section",
1522
- "key": "dong_hang",
1523
- "title": "Dòng hàng",
1524
- "children": [
1525
- {
1526
- "type": "List",
1527
- "entity": "dong_don",
1528
- "nested": true,
1529
- "columns": [{"field": "so_luong", "edit": true}, "da_dat"]
1530
- }
1531
- ]
1532
- }
1533
- ]
1534
- },
1535
- {
1536
- "type": "Record",
1537
- "entity": "dong_don",
1538
- "children": ["so_luong", {"type": "List", "entity": "nguon", "columns": [{"field": "so_luong", "edit": true}]}]
1539
- },
1540
- {"type": "Record", "entity": "khach_hang", "add": ["ten", "dia_chi", "dien_thoai"]},
1541
- {"type": "Record", "entity": "mat_hang", "add": ["ten", "don_vi"]},
1542
- {"type": "Record", "entity": "nha_cung_cap", "add": ["ten", "loai", "dien_thoai"]}
1543
- ]
1544
- }
1545
- }
1546
- ```
1547
-
1548
1455
  ## Calls
1549
1456
 
1550
1457
  **The job.** Call a lead from their record, and keep what was said as a touch on its timeline.
package/docs/workflows.md CHANGED
@@ -149,8 +149,9 @@ A body names a table or document template by its alias (`query_records({ table_i
149
149
  1. **A body names a table's fields and select options by alias**, the names the table's document states: a field reads
150
150
  as `record["status"]`, an option as `"done"`, a linked field as `linked(record["customer"])[0]["name"]`, in the
151
151
  body of a Workflow node, of an Act's own `workflow`, of an automation and of a table's workflow (`set_workflow`). It is stored by key and `get_workflow` shows it by alias
152
- again. A field's or option's key is accepted where its alias is and is kept as written; a display name is refused with the
153
- aliases there are, and a row that names one field by both its alias and its key is refused. A row written to a table is
152
+ again. A field's key is accepted where its alias is and is kept as written; an option's key is read as that option's
153
+ alias, and one that two tables' options share with different aliases is refused where it is read, naming both. A
154
+ display name is refused with the aliases there are, and a row that names one field by both its alias and its key is refused. A row written to a table is
154
155
  stored by field key wherever the save can follow it to the record tool that writes it: a row or list written in the call,
155
156
  a conditional of them, a name holding them, pushed to a `let`, and through `map`, `flatMap`, `concat`, `filter`, `sortBy`,
156
157
  `slice` and `reverse`. A field of such rows is read by alias as well (`picks.toSorted((a, b) => a.quantity - b.quantity)`,
@@ -164,7 +165,7 @@ A body names a table or document template by its alias (`query_records({ table_i
164
165
  name set from the field (`const s = record.status; s == "done"`) or in a list that search runs over
165
166
  (`includes(filter(record.tags, …), "hot")`). A select value handed on whole (returned for a declared select, written to a
166
167
  select field or a filter) is resolved to the option's key where it leaves the body; one handed to a text, a message or a
167
- template carries the alias. An option key bound to a name and compared with a select is refused. A link reads as the list of its row ids, a
168
+ template carries the alias. A link reads as the list of its row ids, a
168
169
  one-row link too: `first(record.customer)` is the one id, and `record.customer` used as one id is refused at save,
169
170
  naming `first(record.customer)`. A one-row link is written with its one id or a list of one; a many-row link with a list. A lookup reads as one flat list of the values it looks up: `includes(record.owner,
170
171
  me)`; a looked-up link, as the ids of its rows, which `query_records` takes as `record_ids`. A select's value is one of another select's options where the two state the same alias for it; two selects that
@@ -179,8 +180,8 @@ A body names a table or document template by its alias (`query_records({ table_i
179
180
  6. **`option("<field>", "<option>")` names an option where no select is beside it** (a name set once and compared later,
180
181
  a list of options, a value handed to a tool). It reads as the option, typed as that select's, and is stored as its alias.
181
182
  The field is looked up among the tables the body reaches; a field or option that does not exist is refused naming both, and
182
- a field alias that two tables state with different keys for that option is refused naming each table. A key
183
- option key written out still works, but write `option()`: a key is a value no one can read.
183
+ a field alias that two tables state with different keys for that option is refused naming each table. An option
184
+ key written out reads as its alias, but write `option()`: a key is a value no one can read.
184
185
  7. **Text renders labels.** Inside a template or a text tool input, a select, member or link value renders its display
185
186
  text: `` `${record["status"]}` `` writes "Done", not `done`, and `` `${record["status"] ?? ""}` `` writes it too. A
186
187
  formula stating `options` (a computed category) is read as the single select it is drawn as: compared by option,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lotics/cli",
3
- "version": "0.320.7",
3
+ "version": "0.320.9",
4
4
  "description": "Lotics SDK and CLI for AI agents",
5
5
  "type": "module",
6
6
  "bin": {