@ai-matrx/records 0.76.16 → 0.76.19

package/dist/{subscription-D8OHY3kw.d.ts → subscription-DxtZgyFR.d.ts}

@@ -192,7 +192,13 @@ declare function publicFormPath(formId: string): string;
 /** The measures the store offers. Asked of `custom.agg_operations()` at run time too. */
 type AggregateOperation = "count" | "sum" | "avg" | "min" | "max"
 /** GRID-PRIMITIVES G1: the summary bar's other four. Blank = no value, JSON null or "". */
- | "median" | "filled" | "empty" | "unique";
+ | "median" | "filled" | "empty" | "unique"
+/**
+ * Notion's calculation row (Spaces N6): the share of the rows asked with no value / a value, as a
+ * percent 0..100 (NULL over no rows); and the RANGE, largest minus smallest (a date column: the days
+ * between its earliest and latest moment).
+ */
+ | "percent_empty" | "percent_filled" | "range";
 /** The periods a date Field can be bucketed into (`custom.agg_buckets()`). */
 type AggregateBucket = "day" | "week" | "month" | "quarter" | "year";
 /**

package/dist/{subscription-BJgDMerQ.d.cts → subscription-vpnl6GxJ.d.cts}

@@ -192,7 +192,13 @@ declare function publicFormPath(formId: string): string;
 /** The measures the store offers. Asked of `custom.agg_operations()` at run time too. */
 type AggregateOperation = "count" | "sum" | "avg" | "min" | "max"
 /** GRID-PRIMITIVES G1: the summary bar's other four. Blank = no value, JSON null or "". */
- | "median" | "filled" | "empty" | "unique";
+ | "median" | "filled" | "empty" | "unique"
+/**
+ * Notion's calculation row (Spaces N6): the share of the rows asked with no value / a value, as a
+ * percent 0..100 (NULL over no rows); and the RANGE, largest minus smallest (a date column: the days
+ * between its earliest and latest moment).
+ */
+ | "percent_empty" | "percent_filled" | "range";
 /** The periods a date Field can be bucketed into (`custom.agg_buckets()`). */
 type AggregateBucket = "day" | "week" | "month" | "quarter" | "year";
 /**

package/dist/templates/index.cjs

@@ -3079,6 +3079,12 @@ function storeAggregate(rows, measure, filter, timeZone) {
   if (op === "filled") return { ok: true, value: present.length, exact: true };
   if (op === "empty") return { ok: true, value: live.length - present.length, exact: true };
   if (op === "unique") return { ok: true, value: new Set(present).size, exact: true };
+  if (op === "percent_empty" || op === "percent_filled") {
+    if (!live.length) return { ok: true, value: null, exact: true };
+    const share = q(100n * BigInt(op === "percent_filled" ? present.length : live.length - present.length), BigInt(live.length));
+    const pct = qToNumber(share);
+    return pct === null ? { ok: true, value: Number(share.n) / Number(share.d), exact: false } : { ok: true, value: pct, exact: true };
+  }
   const nums = [];
   for (const t of present) {
     const v = parseNumeric(t);
@@ -3092,6 +3098,10 @@ function storeAggregate(rows, measure, filter, timeZone) {
     if (op === "avg") result = q(result.n, result.d * BigInt(nums.length));
   } else if (op === "min" || op === "max") {
     result = nums.reduce((a, b) => (op === "min" ? qCmp(b, a) < 0 : qCmp(b, a) > 0) ? b : a);
+  } else if (op === "range") {
+    const lo = nums.reduce((a, b) => qCmp(b, a) < 0 ? b : a);
+    const hi = nums.reduce((a, b) => qCmp(b, a) > 0 ? b : a);
+    result = qAdd(hi, q(-lo.n, lo.d));
   } else if (op === "median") {
     const s = [...nums].sort(qCmp);
     const mid = Math.floor(s.length / 2);
@@ -3128,7 +3138,7 @@ var TIME_BOUND_STAGE = /\b(?:no[- ]?show|completed?|done|seen|checked[- ]?in|arr
 var TERMINAL_STAGE = /^(?:cancell?ed|no[- ]?show|lost|closed[- ]lost|declined|closed|withdrawn|fell off|rejected|void(?:ed)?|skipped|missed)$/i;
 var CHART_BLOCK_KINDS = /* @__PURE__ */ new Set(["bar", "column", "line", "donut"]);
 var BUCKETS = ["year", "quarter", "month", "week", "day"];
-var AGG_OPERATIONS = ["count", "sum", "avg", "min", "max", "median", "filled", "empty", "unique"];
+var AGG_OPERATIONS = ["count", "sum", "avg", "min", "max", "median", "filled", "empty", "unique", "percent_empty", "percent_filled", "range"];
 var MEASURE_KEY = /^[a-zA-Z_][a-zA-Z0-9_]{0,62}$/;
 var STORE_LIST_RELATION_MAX = 25;
 function ruleBreak(field2, v) {
@@ -4143,7 +4153,7 @@ function validateTemplate(raw, options = {}) {
       if (!m.op || !AGG_OPERATIONS.includes(m.op) || m.op === "count") say(mat, `The measure "${m.key}" needs one of: ${AGG_OPERATIONS.filter((o) => o !== "count").join(", ")}.`);
       const of = m.of ? fieldOf(dim.table, m.of) : void 0;
       if (!of) say(mat, `The measure "${m.key}" reads "${m.of ?? "(nothing)"}", which is not a column of "${dim.table}".`);
-      else if (m.op && ["sum", "avg", "min", "max", "median"].includes(m.op) && !(isNumber(of) && !isComputed(of))) say(mat, isComputed(of) ? `"${m.of}" is worked out, and a dimension totals only a number that is typed in; total the stored columns it is made from.` : `"${m.of}" is not a number, so it cannot be added up or averaged.`);
+      else if (m.op && ["sum", "avg", "min", "max", "median", "range"].includes(m.op) && !(isNumber(of) && !isComputed(of))) say(mat, isComputed(of) ? `"${m.of}" is worked out, and a dimension totals only a number that is typed in; total the stored columns it is made from.` : `"${m.of}" is not a number, so it cannot be added up or averaged.`);
       if (newMeasures.has(m.key)) say(mat, `Two measures are both called "${m.key}".`);
       newMeasures.add(m.key);
     });
@@ -4236,7 +4246,7 @@ function validateTemplate(raw, options = {}) {
           let honest = true;
           for (const m of b.measures ?? []) {
             const f = m.key ? fieldOf(table, m.key) : void 0;
-            if (f && ["sum", "avg", "min", "max", "median"].includes(m.op) && !isNumberish(table, f)) {
+            if (f && (["sum", "avg", "min", "max", "median"].includes(m.op) || m.op === "range" && !isDate(f)) && !isNumberish(table, f)) {
               honest = false;
               say(`${at}.blocks[${bi}]`, `"${b.title}" takes the ${m.op} of "${f.label}", which is not a number.`);
             }
@@ -4565,6 +4575,7 @@ function validateTemplate(raw, options = {}) {
     }
   }
   const refWeek = [0, 1, 2, 3, 4, 5, 6].map((i) => shiftDays(TEMPLATE_REFERENCE_DATE, i));
+  const KEY_PART = "";
   const crossBreaks = () => {
     const out = /* @__PURE__ */ new Map();
     const live = (token) => (state.get(token) ?? []).filter((r) => !r.archived);
@@ -4610,7 +4621,7 @@ function validateTemplate(raw, options = {}) {
             const linked = Array.isArray(ref2) ? ref2.includes(r.key) : ref2 === r.key;
             return linked && (!need.field || (need.in ?? []).includes(storeText(c.values?.[need.field]) ?? ""));
           });
-          if (kids.length < (need.min ?? 1)) out.set(`rc|${t.token}|${r.key}|${st}|${kids.length}`, `"${name(t.token, r)}" is ${st}, which needs ${need.min ?? 1} linked ${byToken.get(need.table)?.labelSingular.toLowerCase() ?? need.table}${need.field ? ` in ${(need.in ?? []).join("/")}` : ""}; it has ${kids.length}.`);
+          if (kids.length < (need.min ?? 1)) out.set(["rc", t.token, r.key, st, kids.length].join(KEY_PART), `"${name(t.token, r)}" is ${st}, which needs ${need.min ?? 1} linked ${byToken.get(need.table)?.labelSingular.toLowerCase() ?? need.table}${need.field ? ` in ${(need.in ?? []).join("/")}` : ""}; it has ${kids.length}.`);
         }
         for (const f of t.fields.filter((x) => x.eligible)) {
           const el = f.eligible;
@@ -4624,7 +4635,7 @@ function validateTemplate(raw, options = {}) {
             if (!ok) {
               const target = fieldOf(t.token, f.key)?.relationTarget ?? "";
               const prow = live(target).find((x) => x.key === who);
-              out.set(`el|${t.token}|${r.key}|${f.key}|${String(who)}|${on}`, `"${name(t.token, r)}" (${on}) has ${f.label.toLowerCase()} "${prow ? name(target, prow) : String(who)}", who holds no ${byToken.get(el.table)?.labelSingular.toLowerCase() ?? el.table}${el.where ? ` (${Object.values(el.where).join(", ")})` : ""} valid on that day.`);
+              out.set(["el", t.token, r.key, f.key, String(who), on].join(KEY_PART), `"${name(t.token, r)}" (${on}) has ${f.label.toLowerCase()} "${prow ? name(target, prow) : String(who)}", who holds no ${byToken.get(el.table)?.labelSingular.toLowerCase() ?? el.table}${el.where ? ` (${Object.values(el.where).join(", ")})` : ""} valid on that day.`);
             }
           }
         }
@@ -4634,7 +4645,7 @@ function validateTemplate(raw, options = {}) {
   };
   const crossSeen = new Set(crossBreaks().keys());
   for (const [k, msg] of crossBreaks()) {
-    const [kind, table, row] = k.split("|");
+    const [kind, table, row] = k.split(KEY_PART);
     if (kind === "rc" || kind === "el") say(`tables (${table}).rows (${row})`, msg);
   }
   const moveOne = (a, at, rawSet) => {