@lotics/cli 0.316.0 → 0.316.2

package/docs/design.md

@@ -176,7 +176,7 @@ stage is signed once per person, read off who moved the row.
 
 #### Readings
 
-A List's Readings stand above the rows and read the rows in view. Lead with the job's headline number —
+A List's Readings stand above the rows and read the rows under the open tab, never narrowed by the controls below them. Lead with the job's headline number —
 its exception as a formula's yes/no in a Reading's `where` (what is short), never a stage the
 status chips already count, nor the overdue rows the register's summary line counts from `records.due` — then at most the mix (`by` a field) and the movement (`by` a date), varied by job. A movement over a date is stated, never defaulted, and so is a sum: a status register with no single select to split by gets no default band.
 A grid (`by` and `across`) reads on a dashboard. A dashboard — an App of Readings and no register — answers one owner's question across jobs, each

package/docs/document_templates.md

@@ -107,6 +107,16 @@ A field can also print as a **QR code** or a **Code 128 barcode** (a picture a p
 
 A record's **photos** (a files field, an act's paper hands each as a file cell `{id, name, mime, url}`) print too, and only for a file whoever makes the paper may read — the same rule the file proxy applies; any other file is never drawn. html: `{{#each photos}}<img src="{{url}}">{{/each}}` (only the data's file cells are inlined; a url typed into a text field stays a link). Word: `{{IMAGE picture(cover, 8)}}`, and `{{FOR p IN photos}}{{IMAGE picture($p, 8)}}{{END-FOR p}}` for several. Excel: `{{cover | picture:6}}` as the whole cell, or `{{this | picture}}` inside `{{#each photos}}` (each row grows to its picture). The number is the width in centimetres (8, or 6 in Excel, by default). `picture` takes one image file: a list (loop over it), a file that is no image or one that cannot be read is refused by name. Photos are embedded at most 1600 pixels across, about 200 dpi at 20 cm.
 
+A Word command (`{{ … }}`) reads the data and calls, by name, a Word helper (`picture`, `qr`, `code128`) or one of these text
+and number functions: `trim`, `trimStart`, `trimEnd`, `lower`, `upper`, `capitalize`, `replace`, `replaceAll`, `removeChars`, `removeSpaces`,
+`startsWith`, `endsWith`, `contains`, `substring`, `padStart`, `padEnd`, `length`, `join`, `split`, `repeat`, `formatNumber`,
+`formatDecimal`, `numberToWords`. It holds no JavaScript method or regular-expression literal: `{{upper(name)}}`,
+`{{formatDecimal(total, 0, "vi-VN")}}`, and `{{removeSpaces(removeChars(cccd || "", ".…"))}}` for the text without its dots,
+ellipses and spaces. `removeChars(text, chars)` removes every character of `text` that occurs in `chars` (a set of characters,
+never a pattern); `removeSpaces(text)` removes every whitespace character of `text`, anywhere in it, the set `trim` trims.
+
+A field named like a function is read as the field, and calling the function then fails.
+
 `set_template`'s description holds each type's exact marker grammar and helper list.
 
 ## Generating a filled file

package/docs/workflows.md

@@ -305,7 +305,8 @@ The same work can be written with the helpers below, which are additions to Java
 - **Math**: `sum`, `sumBy`, `mean`, `meanBy`, `minBy`, `maxBy`, `round`, `ceil`, `floor`, `min`, `max`,
   `abs`, `mod`, `pow`, `sqrt`, `clamp`, `percentage`
 - **Text**: `upper`, `lower`, `capitalize`, `trim`, `contains`, `startsWith`, `endsWith`, `replace`,
-  `replaceAll`, `substring`, `length`, `split`, `join`, `padStart(str, length, char)`,
+  `replaceAll`, `removeChars(str, chars)` (without every character that occurs in `chars`),
+  `removeSpaces(str)` (without any whitespace; a Word template command calls both too), `substring`, `length`, `split`, `join`, `padStart(str, length, char)`,
   `padEnd(str, length, char)`, `formatNumber(x, decimals)` (ungrouped; rounds the decimal, a half away
   from zero: `formatNumber(1.005, 2)` is `1.01`),
   `formatDecimal(x, decimals, locale)` (grouped: `formatDecimal(151000, 0, "vi-VN")` is `151.000`),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.316.0",
+  "version": "0.316.2",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {