@lotics/app-sdk 0.123.7 → 0.123.9

package/dist/index.js

@@ -11370,27 +11370,28 @@ function evaluateCondition(record, fieldByKey, looseCondition, memberContext, fi
   const columnValue = data[fieldKey];
   const field = fieldByKey[fieldKey];
   const resolvedType = field ? resolveFilterType(field) : looseCondition.type;
-  const filterCondition = {
+  let filterCondition = {
     ...looseCondition,
     type: resolvedType
   };
+  let figureFactor = 1;
   if (field !== void 0 && filterCondition.type === "number") {
     const reading = conditionUnit(looseCondition, field, (key) => fieldByKey[key]);
     if (!reading.ok) throw new Error(`Filter on "${fieldKey}": ${reading.reason}`);
     if (reading.unit !== void 0 && filterCondition.value !== null && filterCondition.value !== void 0) {
       const factor = rowUnitFactor(reading.unit, data);
       if (factor === void 0) return false;
-      const inBase = { ...filterCondition, value: multiplyExactly(filterCondition.value, reading.unit.factor) };
-      return matchCell(columnValue, field, inBase, looseCondition, memberContext, fileFacts, factor);
+      figureFactor = factor;
+      filterCondition = { ...filterCondition, value: multiplyExactly(filterCondition.value, reading.unit.factor) };
     }
   }
   if (field?.type === "lookup" && (Array.isArray(columnValue) || columnValue == null)) {
     const values2 = Array.isArray(columnValue) ? columnValue : [];
-    return matchLookup(values2, field, filterCondition, looseCondition, memberContext, fileFacts);
+    return matchLookup(values2, field, filterCondition, looseCondition, memberContext, fileFacts, figureFactor);
   }
-  return matchCell(columnValue, field, filterCondition, looseCondition, memberContext, fileFacts);
+  return matchCell(columnValue, field, filterCondition, looseCondition, memberContext, fileFacts, figureFactor);
 }
-function matchLookup(cell, field, filterCondition, looseCondition, memberContext, fileFacts) {
+function matchLookup(cell, field, filterCondition, looseCondition, memberContext, fileFacts, figureFactor) {
   switch (filterCondition.type) {
     case "select":
     case "select_member":
@@ -11417,7 +11418,7 @@ function matchLookup(cell, field, filterCondition, looseCondition, memberContext
   let anyMatched = false;
   for (const value of values2) {
     const element = filterCondition.type === "text" && typeof value !== "string" && value !== null && value !== void 0 ? String(value) : value;
-    const result = matchCell(element, field, positive, looseCondition, memberContext, fileFacts);
+    const result = matchCell(element, field, positive, looseCondition, memberContext, fileFacts, figureFactor);
     if (result !== null) allSkipped = false;
     if (result === true) {
       anyMatched = true;

package/dist/queries.d.ts

@@ -221,6 +221,9 @@ export interface ExportReport {
     };
     /** The value the report was picked for (its `per`), as the reader names it. */
     per?: string;
+    /** The fields of the picked row a one-link `per` names that `filename` reads as `per_row.<field>`, by field alias: a
+     *  scalar, null where the row holds none. */
+    per_row?: Record<string, string | number | boolean | null>;
 }
 /** One tab of the register: its rows read as the export's own are — same query and params — under its own filter and order. */
 export interface ExportTab {
@@ -228,6 +231,17 @@ export interface ExportTab {
     label: string;
     filter?: QueryFilter;
     sort?: readonly QuerySortKey[];
+    /** A tab of totals over the period: the declared query `query` read again under `params` (the period's two days), its
+     *  rows joined to the tab's by the link column `via`, and the columns `columns` each one's `alias` and header. */
+    totals?: {
+        query: string;
+        params: Record<string, string>;
+        via: string;
+        columns: {
+            alias: string;
+            label: string;
+        }[];
+    };
 }
 /** The file an export makes: the default report workbook — its words in `language`, the rows under `columns` on the
  *  tab `sheet` — or a template the query declares under `templates`, by its name there. */

package/docs/data_fetching.md

@@ -24,7 +24,7 @@ untyped. It is written from the app's live bindings by `lotics app create --cust
 | `useQuery(alias, params?, { rows: false, total: true })` | `total` only, no rows (`total: { by: column }` or `total: { where: { name: filter } }` adds `counts`) | a facet chip, a queue badge, an "N awaiting approval" tile — the size of a set you are not listing |
 | `useQueries(calls, opts?)` | one state per `{ alias, params?, filter?, sort?, aggregate?, total?, rows? }`, in order — a `sort` orders that call's rows before the cap cuts them | reads that are DATA — a list known only at render, one read per item, or one count per stage (`rows: false, total: true`, each state's `.total`); the deploy's alias scan reads a list as dynamic, so every alias in it is still declared. With `aggregate` a call answers the groups of its filtered rows instead of the rows ([queries](./queries.md)) |
 | `queryAll(alias, params?, { filter, sort })` | a promise of every row | outside React, for a job that must hold the whole narrowed set in the browser (the ids an act runs on): it asks page after page until the server says the set ended, never stopping at the 10,000-row cap. The server's rows as stored — no write of this app is drawn over them |
-| `exportQuery(alias, { params, filter, sort, tabs?, report, file, labels? })` | a promise of an `ExportedFile`: `{ filename, mime_type, url, size, created_at }` | every row the narrowed set holds, made into one file by the server — no row reaches the browser. `tabs` (2 to 5, each `{ tab, label, filter?, sort? }`) are each read as the export's own rows are — same query and params, under the tab's own filter and sort (absent, the declared order) — and a template reads each one's rows under its `tab`, a name none of the report's keys nor the template's `rows` key holds. `report` is `{ title, lines, readings, dates?, period?, per?, filename? }` — `dates` each date filter's `{ from?, to? }` by field alias, each bound a day (`yyyy-MM-dd`) or a minute of one (`yyyy-MM-ddTHH:mm`) with no zone; `period` the tabs' `{ from, to }`, bounds of the same form; `per` the value the report was picked for, in the reader's words; `filename` the file's name in the template grammar over one value each — `title`, `at` (the moment the server made the file), `dates.<field>.from` or `.to`, `period.from` or `.to`, `per`, `lines | lookup:<n>` — at most 200 bytes once filled (absent, the template's name, or `title`); `file` is `{ kind: "workbook", language, sheet, columns }` (the default report workbook, its head closing with the moment the server made it, each column `{ key, header, type }` an output column of the query — a `number` one on a number column, a `date` one on a date or datetime; with `tabs`, one sheet per tab named by its `label` in place of `sheet`) or `{ kind: "template", template }`, one the query declares under `templates` by name ([queries](./queries.md)). `labels`, by `select` output column, the words each option key prints as in either file — a cell no field of the query names (a union's literal column) arrives as its bare key; a cell its field's option names prints as that, a key the map lacks as itself, and a column no select of the query holds as it is. Past 20,000 rows, in any tab, it rejects, never cuts; each caller makes at most 60 exports a minute. The file has no `id` — it is a download, not a workspace file a workflow or a field takes: its `url` is signed for the caller for at most an hour, so download it with `downloadFileFromUrl(url, filename)` (`@lotics/ui/download`) when the promise resolves — a tab `openExternal` opens seconds after the click is a pop-up the browser blocks; the server deletes the file a day after it is made |
+| `exportQuery(alias, { params, filter, sort, tabs?, report, file, labels? })` | a promise of an `ExportedFile`: `{ filename, mime_type, url, size, created_at }` | every row the narrowed set holds, made into one file by the server — no row reaches the browser. `tabs` (2 to 5, each `{ tab, label, filter?, sort?, totals? }`; `totals` is `{ query, params, via, columns }`, the read of a totals tab beside its rows, joined on the link column `via`, refused where that read lacks `via` or a column or answers two groups for one row) are each read as the export's own rows are — same query and params, under the tab's own filter and sort (absent, the declared order) — and a template reads each one's rows under its `tab`, a name none of the report's keys nor the template's `rows` key holds. `report` is `{ title, lines, readings, dates?, period?, per?, per_row?, filename? }` — `dates` each date filter's `{ from?, to? }` by field alias, each bound a day (`yyyy-MM-dd`) or a minute of one (`yyyy-MM-ddTHH:mm`) with no zone; `period` the tabs' `{ from, to }`, bounds of the same form; `per` the value the report was picked for, in the reader's words; `per_row` the picked row's fields by field alias, each a text, number, boolean or `null`, which `filename` and a template read as `per_row.<field>`; `filename` the file's name in the template grammar over one value each — `title`, `at` (the moment the server made the file), `dates.<field>.from` or `.to`, `period.from` or `.to`, `per`, `per_row.<field>`, `lines | lookup:<n>`, with `| add_days:<n>` shifting a date by whole days — at most 200 bytes once filled (absent, the template's name, or `title`); `file` is `{ kind: "workbook", language, sheet, columns }` (the default report workbook, its head closing with the moment the server made it, each column `{ key, header, type }` an output column of the query — a `number` one on a number column, a `date` one on a date or datetime; with `tabs`, one sheet per tab named by its `label` in place of `sheet`) or `{ kind: "template", template }`, one the query declares under `templates` by name ([queries](./queries.md)). `labels`, by `select` output column, the words each option key prints as in either file — a cell no field of the query names (a union's literal column) arrives as its bare key; a cell its field's option names prints as that, a key the map lacks as itself, and a column no select of the query holds as it is. Past 20,000 rows, in any tab, it rejects, never cuts; each caller makes at most 60 exports a minute. The file has no `id` — it is a download, not a workspace file a workflow or a field takes: its `url` is signed for the caller for at most an hour, so download it with `downloadFileFromUrl(url, filename)` (`@lotics/ui/download`) when the promise resolves — a tab `openExternal` opens seconds after the click is a pop-up the browser blocks; the server deletes the file a day after it is made |
 
 Every hook answers the same `QueryState`: `rows`, `truncated`, `total`, `counts`, `loading`,
 `isValidating`, `answeredAt`, `error`, `pending`, `refetch`, `page`, `setPage`, `pageCount`, `hasMore`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/app-sdk",
-  "version": "0.123.7",
+  "version": "0.123.9",
   "description": "The SDK a Lotics custom-code app reads and writes through — typed hooks over the host bridge, cell readers, mount() and AppRouter",
   "type": "module",
   "exports": {