@svgrid/enterprise 3.1.21 → 3.1.23

package/dist/designer/assets/merges-Bg-KqPEl.js

@@ -0,0 +1 @@
+import{n as e}from"./rolldown-runtime-Dd_uD5pT.js";var t=e({buildMergeIndex:()=>r,endOf:()=>s,expandRectToMerges:()=>c,isCovered:()=>a,mergeAt:()=>i,mergeDrawAt:()=>u,originOf:()=>o,stepPastMerge:()=>l}),n=(e,t)=>`${e}:${t}`;function r(e){if(!e||e.length===0)return null;let t=new Map,r=[];for(let i of e){let e=Math.max(1,Math.floor(i.rowSpan)),a=Math.max(1,Math.floor(i.colSpan));if(e===1&&a===1)continue;let o={rowIndex:i.rowIndex,colIndex:i.colIndex,rowSpan:e,colSpan:a};r.push(o);for(let r=o.rowIndex;r<o.rowIndex+e;r+=1)for(let e=o.colIndex;e<o.colIndex+a;e+=1)t.set(n(r,e),o)}return r.length?{list:r,byCell:t}:null}function i(e,t,r){return e?.byCell.get(n(t,r))}function a(e,t,n){let r=i(e,t,n);return!!r&&(r.rowIndex!==t||r.colIndex!==n)}function o(e,t,n){let r=i(e,t,n);return r?{rowIndex:r.rowIndex,colIndex:r.colIndex}:{rowIndex:t,colIndex:n}}function s(e,t,n){let r=i(e,t,n);return r?{rowIndex:r.rowIndex+r.rowSpan-1,colIndex:r.colIndex+r.colSpan-1}:{rowIndex:t,colIndex:n}}function c(e,t){if(!e)return t;let{minRow:n,maxRow:r,minCol:i,maxCol:a}=t;for(let t=0;t<64;t+=1){let t=!1;for(let o of e.list){let e=o.rowIndex+o.rowSpan-1,s=o.colIndex+o.colSpan-1;o.rowIndex<=r&&e>=n&&o.colIndex<=a&&s>=i&&(o.rowIndex<n&&(n=o.rowIndex,t=!0),e>r&&(r=e,t=!0),o.colIndex<i&&(i=o.colIndex,t=!0),s>a&&(a=s,t=!0))}if(!t)break}return n===t.minRow&&r===t.maxRow&&i===t.minCol&&a===t.maxCol?t:{minRow:n,maxRow:r,minCol:i,maxCol:a}}function l(e,t,n,r){if(!e)return n;let a=i(e,n.rowIndex,n.colIndex);if(!a)return n;if(i(e,t.rowIndex,t.colIndex)!==a)return{rowIndex:a.rowIndex,colIndex:a.colIndex};let o=Math.sign(n.rowIndex-t.rowIndex),s=Math.sign(n.colIndex-t.colIndex);if(o===0&&s===0)return{rowIndex:a.rowIndex,colIndex:a.colIndex};let c=n.rowIndex,l=n.colIndex;if(o>0?c=a.rowIndex+a.rowSpan:o<0&&(c=a.rowIndex-1),s>0?l=a.colIndex+a.colSpan:s<0&&(l=a.colIndex-1),c<0||c>r.maxRow||l<0||l>r.maxCol)return{rowIndex:a.rowIndex,colIndex:a.colIndex};let u=i(e,c,l);return u?{rowIndex:u.rowIndex,colIndex:u.colIndex}:{rowIndex:c,colIndex:l}}function u(e,t,n,r){let a=i(e,t,n);if(!a)return null;let o=Math.max(a.rowIndex,r.firstRow),s=Math.max(a.colIndex,r.firstCol);if(t!==o||n!==s)return{kind:`skip`};let c=o===a.rowIndex&&s===a.colIndex,l=Math.max(1,Math.min(a.rowIndex+a.rowSpan-t,r.lastRow-t+1)),u=Math.max(1,Math.min(a.colIndex+a.colSpan-n,r.lastCol-n+1));return{kind:c?`origin`:`continuation`,merge:a,rowSpan:l,colSpan:u}}export{t};

package/dist/designer/index.html

@@ -4,17 +4,17 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>SvGrid Studio - Designer</title>
-    <script type="module" crossorigin src="./assets/index-DLJjuVA4.js"></script>
+    <script type="module" crossorigin src="./assets/index-CIxqRzKJ.js"></script>
     <link rel="modulepreload" crossorigin href="./assets/rolldown-runtime-Dd_uD5pT.js">
     <link rel="modulepreload" crossorigin href="./assets/disclose-version-CIm4S9xS.js">
     <link rel="modulepreload" crossorigin href="./assets/cell-formatting-JoxA0t65.js">
     <link rel="modulepreload" crossorigin href="./assets/SvGrid.helpers-BF2QRcNt.js">
     <link rel="modulepreload" crossorigin href="./assets/sv-grid-scrollbar-B9N6Wuj0.js">
+    <link rel="modulepreload" crossorigin href="./assets/grid-extension.svelte-G1ng0xd2.js">
     <link rel="modulepreload" crossorigin href="./assets/editor-contract-Bpoa7A5g.js">
     <link rel="modulepreload" crossorigin href="./assets/date-format-B8JbEtIG.js">
     <link rel="modulepreload" crossorigin href="./assets/list-option-BP_dWS66.js">
     <link rel="modulepreload" crossorigin href="./assets/SvListBox-fn160gSB.js">
-    <link rel="modulepreload" crossorigin href="./assets/grid-extension.svelte-BZ7AqyJI.js">
     <link rel="modulepreload" crossorigin href="./assets/editor-registry-BjP16H0v.js">
     <link rel="modulepreload" crossorigin href="./assets/preload-helper-HclGiUj8.js">
     <link rel="modulepreload" crossorigin href="./assets/popover-CUkLsvRX.js">
@@ -45,7 +45,7 @@
     <link rel="stylesheet" crossorigin href="./assets/SvMenuList-DJ47ba1h.css">
     <link rel="stylesheet" crossorigin href="./assets/SvGridChart-BgLuPO7I.css">
     <link rel="stylesheet" crossorigin href="./assets/SvGridChartPanel-4Pc8y5yO.css">
-    <link rel="stylesheet" crossorigin href="./assets/index-WCxj6WfJ.css">
+    <link rel="stylesheet" crossorigin href="./assets/index-CHx3F4Ij.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/expressions/compile.js

@@ -21,6 +21,7 @@
  *      constants.
  */
 import { compileExcelFilter } from '@svgrid/grid/filtering';
+import { compileRelativeDateFilter, isRelativeDateOperator } from '../relative-date-core.js';
 import { getPredicateKind } from './kinds.js';
 const num = (v) => typeof v === 'number' ? v : v == null || v === '' ? NaN : Number(v);
 const BUILTINS = {
@@ -258,13 +259,16 @@ function compileInternal(expr, opts, aggs) {
             return test ?? (() => true);
         }
         case 'cmp': {
-            // The needle-side work happens once, here.
-            const test = compileExcelFilter({
-                id: expr.column,
-                operator: expr.op,
-                value: expr.value,
-                valueTo: expr.valueTo,
-            }, { locale: opts.locale });
+            // The needle-side work happens once, here. The relative date operators
+            // are this package's, not the grid's.
+            const test = isRelativeDateOperator(expr.op)
+                ? compileRelativeDateFilter(expr.op)
+                : compileExcelFilter({
+                    id: expr.column,
+                    operator: expr.op,
+                    value: expr.value,
+                    valueTo: expr.valueTo,
+                }, { locale: opts.locale });
             const column = expr.column;
             return (row) => test(opts.getValue(row, column));
         }

package/dist/expressions/evaluate.js

@@ -4,6 +4,7 @@
  * exactly; scalar maths and change detection are handled here.
  */
 import { applyExcelFilter } from '@svgrid/grid/filtering';
+import { compileRelativeDateFilter, isRelativeDateOperator } from '../relative-date-core.js';
 import { getPredicateKind } from './kinds.js';
 function readValue(ctx, row, columnId) {
     if (ctx.getValue)
@@ -168,6 +169,9 @@ export function evaluatePredicate(expr, ctx) {
         case 'not':
             return !evaluatePredicate(expr.expr, ctx);
         case 'cmp':
+            // The relative date operators are this package's, not the grid's.
+            if (isRelativeDateOperator(expr.op))
+                return compileRelativeDateFilter(expr.op)(readValue(ctx, ctx.row, expr.column));
             return applyExcelFilter(readValue(ctx, ctx.row, expr.column), { id: expr.column, operator: expr.op, value: expr.value, valueTo: expr.valueTo }, { locale: ctx.locale });
         case 'scalarCmp':
             return compareScalar(evaluateScalar(expr.left, ctx), expr.op, evaluateScalar(expr.right, ctx));

package/dist/expressions/expression-columns.d.ts

@@ -27,7 +27,10 @@ export declare const OPERATORS: ReadonlyArray<OperatorMeta>;
 export declare function operatorMeta(op: ExcelFilterOperator): OperatorMeta;
 /** Operators valid for a column type (defaults to the text set). */
 export declare function operatorsForType(type: ExprColumnType | undefined): OperatorMeta[];
-/** Whether an operator needs no value input. Delegates to the grid catalogue. */
+/**
+ * Whether an operator needs no value input: the grid catalogue's, or one of
+ * the relative date operators this package adds.
+ */
 export declare function isValueless(op: ExcelFilterOperator): boolean;
 /** Whether an operator takes a multi-value token list. */
 export declare function isSetOperator(op: ExcelFilterOperator): boolean;

package/dist/expressions/expression-columns.js

@@ -16,6 +16,7 @@
 // Imported from the `/filtering` subpath, not the package root: the root would
 // drag SvGrid.svelte into a module that is otherwise pure logic.
 import { isRangeOperator as gridIsRangeOperator, isSetOperator as gridIsSetOperator, isValuelessOperator as gridIsValuelessOperator, } from '@svgrid/grid/filtering';
+import { isRelativeDateOperator } from '../relative-date-core.js';
 const TEXT = ['text'];
 const NUM = ['number'];
 const DATES = ['date', 'datetime'];
@@ -40,11 +41,16 @@ const OPERATOR_PRESENTATION = [
     { value: 'notIn', label: 'Not in', types: ['text', 'number'] },
     { value: 'isBlank', label: 'Is blank', types: ALL },
     { value: 'isNotBlank', label: 'Is not blank', types: ALL },
+    { value: 'today', label: 'Is today', types: DATES },
+    { value: 'beforeToday', label: 'Before today', types: DATES },
+    { value: 'afterToday', label: 'After today', types: DATES },
+    { value: 'next7Days', label: 'In the next 7 days', types: DATES },
+    { value: 'last7Days', label: 'In the last 7 days', types: DATES },
 ];
 /** The full operator catalogue, ordered as the editor should present it. */
 export const OPERATORS = OPERATOR_PRESENTATION.map((op) => ({
     ...op,
-    ...(gridIsValuelessOperator(op.value) ? { valueless: true } : {}),
+    ...(isValueless(op.value) ? { valueless: true } : {}),
     ...(gridIsSetOperator(op.value) ? { set: true } : {}),
     ...(gridIsRangeOperator(op.value) ? { range: true } : {}),
 }));
@@ -58,9 +64,12 @@ export function operatorsForType(type) {
     const t = type ?? 'text';
     return OPERATORS.filter((op) => op.types.includes(t));
 }
-/** Whether an operator needs no value input. Delegates to the grid catalogue. */
+/**
+ * Whether an operator needs no value input: the grid catalogue's, or one of
+ * the relative date operators this package adds.
+ */
 export function isValueless(op) {
-    return gridIsValuelessOperator(op);
+    return gridIsValuelessOperator(op) || isRelativeDateOperator(op);
 }
 /** Whether an operator takes a multi-value token list. */
 export function isSetOperator(op) {

package/dist/expressions/parse.js

@@ -5,7 +5,19 @@ const KEYWORDS = new Set([
     'AND', 'OR', 'NOT', 'TRUE', 'FALSE', 'NULL',
     'CONTAINS', 'STARTSWITH', 'ENDSWITH', 'MATCHES',
     'IN', 'BETWEEN', 'ISBLANK', 'ISNOTBLANK',
+    'ISTODAY', 'BEFORETODAY', 'AFTERTODAY', 'INNEXT7DAYS', 'INLAST7DAYS',
 ]);
+/** The operators that take no value, written after the column: `Due ISTODAY`. */
+const POSTFIX_OPS = {
+    ISBLANK: 'isBlank',
+    ISNOTBLANK: 'isNotBlank',
+    ISTODAY: 'today',
+    BEFORETODAY: 'beforeToday',
+    AFTERTODAY: 'afterToday',
+    INNEXT7DAYS: 'next7Days',
+    INLAST7DAYS: 'last7Days',
+};
+const POSTFIX_KEYWORD = Object.fromEntries(Object.entries(POSTFIX_OPS).map(([kw, op]) => [op, kw]));
 const AGG_KEYWORDS = new Set(['SUM', 'AVG', 'COUNT']);
 function tokenize(input) {
     const tokens = [];
@@ -192,9 +204,10 @@ class Parser {
         const left = this.parseScalar();
         const t = this.peek();
         // Postfix valueless keyword ops.
-        if (this.isKw('ISBLANK') || this.isKw('ISNOTBLANK')) {
-            const op = this.next().value === 'ISBLANK' ? 'isBlank' : 'isNotBlank';
-            return { kind: 'cmp', column: this.expectColumn(left), op };
+        const postfix = t.kind === 'kw' ? POSTFIX_OPS[t.value] : undefined;
+        if (postfix) {
+            this.next();
+            return { kind: 'cmp', column: this.expectColumn(left), op: postfix };
         }
         // Keyword text/set/range ops.
         if (t.kind === 'kw') {
@@ -424,10 +437,9 @@ export function stringifyPredicate(expr, columns = []) {
             return getPredicateKind(expr.type)?.describe?.(expr.payload, (id) => columnLabel(columns, id)) ?? `[${expr.type}]`;
         case 'cmp': {
             const col = columnRefText(columns, expr.column);
-            if (expr.op === 'isBlank')
-                return `${col} ISBLANK`;
-            if (expr.op === 'isNotBlank')
-                return `${col} ISNOTBLANK`;
+            const postfix = POSTFIX_KEYWORD[expr.op];
+            if (postfix)
+                return `${col} ${postfix}`;
             if (expr.op === 'between')
                 return `${col} BETWEEN ${litText(expr.value)} AND ${litText(expr.valueTo)}`;
             if (expr.op === 'in' || expr.op === 'notIn') {

package/dist/fields/RecordView.svelte

@@ -143,7 +143,7 @@
 
   // ---- Activity ---------------------------------------------------------------
   const allCols = $derived([...columns, ...hidden])
-  type FeedItem = { key: string; at: number; by?: string; automation?: string; remote?: boolean; kind: 'edit' | 'added' | 'comment'; field: string; text: string; from?: string }
+  type FeedItem = { key: string; at: number; by?: string; automation?: string; via?: string; remote?: boolean; kind: 'edit' | 'added' | 'comment'; field: string; text: string; from?: string }
   const feed = $derived.by(() => {
     if (!row) return []
     const edits = changesOf(ctrl, row.id).map((ch): FeedItem => {
@@ -155,6 +155,7 @@
         at: ch.at,
         by: ch.by,
         automation: ch.automation,
+        via: ch.via,
         remote: ch.remote,
         kind: 'edit',
         field: c ? label(c) : ch.columnId,
@@ -166,8 +167,10 @@
     const notes = commentsOf(ctrl, row.id).map((n): FeedItem => ({ key: n.id, at: n.at, by: n.by, kind: 'comment', field: '', text: n.text }))
     return [...edits, ...notes].sort((a, b) => a.at - b.at)
   })
+  const person = (item: FeedItem) => (item.by ? (findFieldUser(item.by)?.name ?? 'Someone') : item.remote ? 'Someone else' : 'You')
+  // A proposal someone accepted (change review) is credited to what proposed it, and to them.
   const who = (item: FeedItem) =>
-    item.automation ? `Automation: ${item.automation}` : item.by ? (findFieldUser(item.by)?.name ?? 'Someone') : item.remote ? 'Someone else' : 'You'
+    item.automation ? `Automation: ${item.automation}` : item.via ? `${item.via} (accepted by ${person(item)})` : person(item)
   // Shown here: a change made elsewhere is seen, so the grid stops marking it.
   $effect(() => {
     const id = row?.id

package/dist/fields/activity.svelte.d.ts

@@ -25,6 +25,8 @@ export type RecordChange = {
     by?: string;
     /** The automation that made it, by name. */
     automation?: string;
+    /** What proposed it, when `by` accepted a proposal (change review): "CRM agent". */
+    via?: string;
     /** Made elsewhere (another user, a script, an agent) and read from the database. */
     remote?: boolean;
     /** The record was added elsewhere: one entry, with no field. */
@@ -60,9 +62,10 @@ export declare function setRecordComments(next: RecordCommentStore | null): void
 /**
  * Note a change to a cell (called after every edit, paste, fill and clear).
  * `scope` is the grid, or the table (its base and id) for a change made
- * outside it (an automation). `automation` names the automation that made it.
+ * outside it (an automation). `automation` names the automation that made it;
+ * `via` names what proposed a change the signed-in user accepted.
  */
-export declare function noteChange(scope: ActivityScope, rowId: string, columnId: string, value: unknown, automation?: string): void;
+export declare function noteChange(scope: ActivityScope, rowId: string, columnId: string, value: unknown, automation?: string, via?: string): void;
 export declare function changesOf(scope: ActivityScope, rowId: string): ReadonlyArray<RecordChange>;
 /**
  * Note a change made elsewhere and read from the database: an activity entry

package/dist/fields/activity.svelte.js

@@ -50,13 +50,14 @@ export function setRecordComments(next) {
 /**
  * Note a change to a cell (called after every edit, paste, fill and clear).
  * `scope` is the grid, or the table (its base and id) for a change made
- * outside it (an automation). `automation` names the automation that made it.
+ * outside it (an automation). `automation` names the automation that made it;
+ * `via` names what proposed a change the signed-in user accepted.
  */
-export function noteChange(scope, rowId, columnId, value, automation) {
+export function noteChange(scope, rowId, columnId, value, automation, via) {
     const byRow = rowsOf(changes, scope, true);
     const list = byRow.get(rowId) ?? [];
     // Kept short: the panel shows the latest.
-    list.push({ at: Date.now(), ...(automation ? { automation } : { by: getCurrentUser()?.id }), columnId, value: Array.isArray(value) ? [...value] : value });
+    list.push({ at: Date.now(), ...(automation ? { automation } : { by: getCurrentUser()?.id }), ...(via ? { via } : {}), columnId, value: Array.isArray(value) ? [...value] : value });
     if (list.length > 50)
         list.splice(0, list.length - 50);
     byRow.set(rowId, list);

package/dist/fields/grid-access.d.ts

@@ -16,7 +16,7 @@ export type FieldColumn = {
 };
 /** Called on every draw of a grid with fields turned on. */
 export declare function rememberGrid(ctrl: any): void;
-/** The grid an api belongs to; undefined until that grid has drawn once. */
+/** The grid an api belongs to (or a `$state` proxy of it); undefined until that grid has drawn once. */
 export declare function gridOf(api: unknown): any;
 export declare const columnIdOf: (def: Record<string, any>) => string;
 /** Every data column (declared ones with a field), in screen order, hidden ones last. */

package/dist/fields/grid-access.js

@@ -7,15 +7,25 @@
 import { getAdvancedFilterEngine } from '@svgrid/grid';
 // The grid behind each api object (the grid keeps one api per grid).
 const grids = new WeakMap();
+// The same, by one of the api's methods. An app that keeps the api in
+// `$state` hands over a proxy of it, which is not the object above; Svelte
+// does not proxy functions, so the proxy's methods are the api's own.
+const byMethod = new WeakMap();
 /** Called on every draw of a grid with fields turned on. */
 export function rememberGrid(ctrl) {
     const api = ctrl?.buildApi?.();
-    if (api && !grids.has(api))
+    if (api && !grids.has(api)) {
         grids.set(api, ctrl);
+        if (typeof api.getData === 'function')
+            byMethod.set(api.getData, ctrl);
+    }
 }
-/** The grid an api belongs to; undefined until that grid has drawn once. */
+/** The grid an api belongs to (or a `$state` proxy of it); undefined until that grid has drawn once. */
 export function gridOf(api) {
-    return api && typeof api === 'object' ? grids.get(api) : undefined;
+    if (!api || typeof api !== 'object')
+        return undefined;
+    const getData = api.getData;
+    return grids.get(api) ?? (typeof getData === 'function' ? byMethod.get(getData) : undefined);
 }
 export const columnIdOf = (def) => String(def.id ?? def.field ?? '');
 /** Every data column (declared ones with a field), in screen order, hidden ones last. */

package/dist/fields/index.d.ts

@@ -25,6 +25,24 @@ export type { FieldView, FieldViewType, ColorSetting } from './view-model.js';
 export type { FieldPropertyDef, FieldEditorContext, FieldFillContext, FieldRowContext } from './registry.svelte.js';
 export { BUILTIN_FIELD_TYPES } from './builtin-types.js';
 export { setAttachmentUploader, attachmentsFromText, attachmentsText, toAttachments, type Attachment, type AttachmentFieldProps, type AttachmentUploader, type AttachmentUploadContext, } from './attachments.js';
+/**
+ * Change review (`@svgrid/enterprise/review`) in SvGrid Base: what an edit
+ * does, done for each accepted proposal. Last modified time / by fields are
+ * stamped, and the record's activity notes the change, credited to the
+ * signed-in user who accepted it and to what proposed it ("CRM agent
+ * (accepted by Dana)"). An undo is noted as the user's own change.
+ *
+ * ```ts
+ * const review = createReview({ api: () => api, setRows, onApply: baseReviewApplied(() => api) })
+ * ```
+ */
+export declare function baseReviewApplied(api: unknown): (applied: ReadonlyArray<{
+    rowId: string;
+    field: string;
+    source: {
+        label: string;
+    };
+}>, how: 'accept' | 'undo' | 'redo', rows?: ReadonlyArray<unknown>) => void;
 /**
  * Turn field types on for every `<SvGrid>` on the page: registers the
  * built-in types and plugs the cell drawing into the grid. Safe to call more

package/dist/fields/index.js

@@ -184,6 +184,37 @@ function stampModified(ctrl, row, columnId) {
             overlay(id, (row[c.field] = author));
     }
 }
+/**
+ * Change review (`@svgrid/enterprise/review`) in SvGrid Base: what an edit
+ * does, done for each accepted proposal. Last modified time / by fields are
+ * stamped, and the record's activity notes the change, credited to the
+ * signed-in user who accepted it and to what proposed it ("CRM agent
+ * (accepted by Dana)"). An undo is noted as the user's own change.
+ *
+ * ```ts
+ * const review = createReview({ api: () => api, setRows, onApply: baseReviewApplied(() => api) })
+ * ```
+ */
+export function baseReviewApplied(api) {
+    return (applied, how, next) => {
+        const ctrl = gridOf(typeof api === 'function' ? api() : api);
+        if (!ctrl)
+            return;
+        const gridApi = ctrl.buildApi?.();
+        const idOf = gridApi?.getOption?.('getRowId');
+        const rows = new Map();
+        (next ?? gridApi?.getData?.() ?? []).forEach((r, i) => rows.set(String(idOf ? idOf(r, i) : i), r));
+        const columnOf = new Map((ctrl.allColumns ?? []).map((c) => [c.columnDef?.field, c.id]));
+        for (const p of applied) {
+            const row = rows.get(p.rowId);
+            const columnId = columnOf.get(p.field);
+            if (!row || !columnId)
+                continue;
+            stampModified(ctrl, row, columnId);
+            noteChange(ctrl, p.rowId, columnId, row[p.field], undefined, how === 'undo' ? undefined : p.source.label);
+        }
+    };
+}
 /** The record's activity: what a cell now holds after an edit. */
 function noteEdit(ctrl, row, columnId) {
     if (!row)

package/dist/filter-labels.d.ts

@@ -0,0 +1,16 @@
+type FacetOption = {
+    value: string;
+    label: string;
+    hint?: string;
+};
+/**
+ * The checklist as the cells show it. Exported for tests and for a custom
+ * menu; `enableFilterLabels` wires it into every grid.
+ */
+export declare function labelFacetOptions(ctrl: any, column: any, options: ReadonlyArray<FacetOption>): FacetOption[];
+/**
+ * Label every grid's filter checklists as their cells show them. Idempotent;
+ * also invoked by {@link installEnterprise}.
+ */
+export declare function enableFilterLabels(): void;
+export {};

package/dist/filter-labels.js

@@ -0,0 +1,83 @@
+/**
+ * Filter checklist labels - the column filter's value list shows each value
+ * the way its cell shows it, while the filter still matches the raw value. A
+ * status stored as MARKED_AS_FAILED and drawn as "Failed" is offered as
+ * "Failed", so a column's accessor can stay the raw value that sorting needs.
+ *
+ * The label comes from the first of these the column has: a `cell` renderer
+ * that returns a string, static `editorOptions` labels, then `formatter` /
+ * `format`. Text values are ordered by label; number and date values stay in
+ * value order. It plugs into the grid's `facetOptions` seam, which runs in the
+ * menu chunk.
+ *
+ * ```ts
+ * import { enableFilterLabels } from '@svgrid/enterprise'
+ * enableFilterLabels()
+ * ```
+ */
+import { columnDataType, registerGridExtension } from '@svgrid/grid';
+import { hasValidLicense } from './license.js';
+import { emitUnlicensedNudge } from './watermark.js';
+/** The text a cell shows for `raw` in `row`, or null when the column draws markup only. */
+function cellText(ctrl, column, raw, row) {
+    const def = column.columnDef;
+    if (typeof def.cell === 'function') {
+        const rendered = def.cell({
+            cell: { id: `${row.id}_${column.id}`, row, column, getValue: () => raw, getContext: () => ({}) },
+            row,
+            column,
+            table: ctrl.grid,
+            getValue: () => raw,
+        });
+        if (typeof rendered === 'string' || typeof rendered === 'number')
+            return String(rendered);
+    }
+    // Static lists only: a function or promise source would fetch.
+    if (Array.isArray(def.editorOptions))
+        return ctrl.formatListCellValue(column, raw, row);
+    if (def.formatter || def.format)
+        return ctrl.formatCellValue(column, raw, row);
+    return null;
+}
+/**
+ * The checklist as the cells show it. Exported for tests and for a custom
+ * menu; `enableFilterLabels` wires it into every grid.
+ */
+export function labelFacetOptions(ctrl, column, options) {
+    // One row per distinct value, found once per menu open.
+    const wanted = new Set(options.map((o) => o.value));
+    const rowFor = new Map();
+    for (const row of ctrl.grid.getRowModel().rows) {
+        if (rowFor.size === wanted.size)
+            break;
+        const raw = row.getCellValueByColumnId(column.id);
+        const key = String(raw ?? '');
+        if (wanted.has(key) && !rowFor.has(key))
+            rowFor.set(key, { raw, row });
+    }
+    const out = options.map((o) => {
+        const hit = o.value === '' ? undefined : rowFor.get(o.value);
+        const text = hit ? cellText(ctrl, column, hit.raw, hit.row) : null;
+        return text == null ? o : { ...o, label: text };
+    });
+    // Numbers and dates keep value order ("$1,000" would collate before "$200").
+    const type = columnDataType(column.columnDef);
+    if (type === 'number' || type === 'date' || type === 'dateString')
+        return out;
+    return out.sort((a, b) => a.value === '' || b.value === ''
+        ? (a.value === '' ? 0 : 1) - (b.value === '' ? 0 : 1)
+        : a.label.localeCompare(b.label, undefined, { numeric: true }));
+}
+let enabled = false;
+/**
+ * Label every grid's filter checklists as their cells show them. Idempotent;
+ * also invoked by {@link installEnterprise}.
+ */
+export function enableFilterLabels() {
+    if (enabled)
+        return;
+    enabled = true;
+    registerGridExtension({ facetOptions: labelFacetOptions });
+    if (!hasValidLicense())
+        emitUnlicensedNudge();
+}

package/dist/index.d.ts

@@ -12,6 +12,10 @@ export { enableBoardView, SvGridBoard } from './board.js';
 export { enableGalleryView, SvGridGallery } from './gallery.js';
 export * from './gantt/index.js';
 export { enableSelectionBar, SvGridSelectionBar } from './selection-bar.js';
+export { enableRelativeDateFilters, resolveRelativeDateFilter, compileRelativeDateFilter, isRelativeDateOperator, relativeDateOperators, RELATIVE_DATE_OPERATOR_IDS, type RelativeDateOperator, } from './relative-dates.js';
+export { enableFilterLabels, labelFacetOptions } from './filter-labels.js';
+export { enableRowCount, getRowCounts, SvGridRowCount } from './row-count.js';
+export { blanksLast, blanksFirst, type BlanksSortType } from './sort-blanks.js';
 export { applyBulkEdit, bulkEditableFields, bulkEditInitialValues, coerceBulkValue, type BulkEditField, type BulkEditResult } from './bulk-edit.js';
 export { default as SvGridBulkEditDrawer } from './SvGridBulkEditDrawer.svelte';
 export { enablePivot } from './pivot-enable.js';

package/dist/index.js

@@ -33,6 +33,13 @@ export * from './gantt/index.js';
 // the renderer so `<SvGrid selectionBar={...}>` floats a bar over the grid while
 // rows are selected. The prop + its config types live in @svgrid/grid.
 export { enableSelectionBar, SvGridSelectionBar } from './selection-bar.js';
+// Filter and sort additions for every grid (Pro), each through a grid seam so
+// the free grid carries none of it: relative date operators, checklist labels
+// taken from the cells, a status-bar row count, and blanks held at one end.
+export { enableRelativeDateFilters, resolveRelativeDateFilter, compileRelativeDateFilter, isRelativeDateOperator, relativeDateOperators, RELATIVE_DATE_OPERATOR_IDS, } from './relative-dates.js';
+export { enableFilterLabels, labelFacetOptions } from './filter-labels.js';
+export { enableRowCount, getRowCounts, SvGridRowCount } from './row-count.js';
+export { blanksLast, blanksFirst } from './sort-blanks.js';
 // Bulk edit engine behind the bar's `editFields` button - exported so an app
 // can drive the same write from its own UI.
 export { applyBulkEdit, bulkEditableFields, bulkEditInitialValues, coerceBulkValue } from './bulk-edit.js';

package/dist/install.js

@@ -12,6 +12,9 @@ import { enableBoardView } from './board.js';
 import { enableGalleryView } from './gallery.js';
 import { enableGanttView } from './gantt/gantt.js';
 import { enableSelectionBar } from './selection-bar.js';
+import { enableRelativeDateFilters } from './relative-dates.js';
+import { enableFilterLabels } from './filter-labels.js';
+import { enableRowCount } from './row-count.js';
 import { enableAdvancedFilter } from './advanced-filter-enable.js';
 import { enablePivot } from './pivot-enable.js';
 import { registerSheetKeymap } from './sheet-enable.js';
@@ -52,6 +55,11 @@ export function installEnterprise(api) {
     // Register the Gantt view (no-op without the `gantt` prop).
     enableGanttView();
     enableSelectionBar();
+    // Relative date operators, cell-text checklist labels and the status-bar row
+    // count (each a no-op until a grid uses it).
+    enableRelativeDateFilters();
+    enableFilterLabels();
+    enableRowCount();
     // Register the export engine so built-in AI exports (aiExport) can write the
     // enterprise formats (xlsx / pdf / ...); free grids without it get the plan only.
     registerExportProvider(exportGrid);

package/dist/node/studio.js

@@ -2242,8 +2242,15 @@ var kinds = /* @__PURE__ */ new Map();
 function getPredicateKind(type) {
 	return kinds.get(type);
 }
-//#endregion
-//#region src/expressions/parse.ts
+Object.fromEntries(Object.entries({
+	ISBLANK: "isBlank",
+	ISNOTBLANK: "isNotBlank",
+	ISTODAY: "today",
+	BEFORETODAY: "beforeToday",
+	AFTERTODAY: "afterToday",
+	INNEXT7DAYS: "next7Days",
+	INLAST7DAYS: "last7Days"
+}).map(([kw, op]) => [op, kw]));
 /** Every column id referenced anywhere in a predicate (deduped, in order). */
 function collectColumnRefs(expr) {
 	const out = /* @__PURE__ */ new Set();
@@ -9336,7 +9343,7 @@ var GENERATED_UI_SURFACE = {
 				"key": "statusBar",
 				"label": "Status Bar",
 				"type": "boolean",
-				"description": "Excel-style status bar under the grid showing live aggregates of the selected cell range (count, numeric count, sum, average, min, max). `true` shows the default set; pass `{ aggregates: [...] }` to choose which. Requires `enableCellSelection`.",
+				"description": "Excel-style status bar under the grid showing live aggregates of the selected cell range (count, numeric count, sum, average, min, max). `true` shows the default set; pass `{ aggregates: [...] }` to choose which. The aggregates need `enableCellSelection`. `rows: true` adds a row count that is always shown, \"250 rows\" or \"12 of 250 rows\" while filters hide some, once `@svgrid/enterprise`'s `enableRowCount()` has run. `{ rows: true, aggregates: [] }` shows the count alone.",
 				"group": "common"
 			},
 			{
@@ -16499,7 +16506,7 @@ function hasFieldConditions(schema) {
 *
 * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
 */
-var SVGRID_VERSION = "3.1.21";
+var SVGRID_VERSION = "3.1.23";
 /**
 * The version of `@svgrid/grid`, which releases on its own line: enterprise is
 * on 3.1.x while the grid is on 3.0.x.
@@ -16512,7 +16519,7 @@ var SVGRID_VERSION = "3.1.21";
 *
 * `version.test.ts` asserts this matches packages/grid/package.json.
 */
-var GRID_VERSION = "3.0.20";
+var GRID_VERSION = "3.0.22";
 //#endregion
 //#region src/studio/emit-project.ts
 var has = (blocks, kind) => blocks.some((b) => b.config.kind === kind);

package/dist/relative-date-core.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The relative date operators' semantics, with no grid import: what the
+ * filter menu (relative-dates.ts) and the expression engine both run, so a
+ * server that evaluates expressions loads none of the grid.
+ */
+declare module '@svgrid/grid/filtering' {
+    interface FilterOperatorExtensions {
+        today: true;
+        beforeToday: true;
+        afterToday: true;
+        next7Days: true;
+        last7Days: true;
+    }
+}
+/** The relative date operator ids, in menu order. */
+export declare const RELATIVE_DATE_OPERATOR_IDS: readonly ["today", "beforeToday", "afterToday", "next7Days", "last7Days"];
+export type RelativeDateOperator = (typeof RELATIVE_DATE_OPERATOR_IDS)[number];
+/** Whether `op` is one of the relative date operators. */
+export declare function isRelativeDateOperator(op: string): op is RelativeDateOperator;
+/**
+ * The test for one relative date operator. "Today" is read once, here, so a
+ * page left open past midnight keeps the old day until the filter changes.
+ * A blank or unparseable cell never matches.
+ */
+export declare function compileRelativeDateFilter(op: RelativeDateOperator, now?: Date): (cellValue: unknown) => boolean;
+/**
+ * A relative date filter as the absolute one it means today, for a backend
+ * with no "today" of its own: `beforeToday` becomes `lessThan` today's date,
+ * `next7Days` becomes `between` today and a week out, and so on, with dates as
+ * local 'YYYY-MM-DD'. Any other filter is returned as it is.
+ *
+ * A server data source gets this applied for it. Under `externalFilter` the
+ * `onFiltersChange` payload keeps the relative operator, so a saved view still
+ * means "overdue" tomorrow; call this when you build the query.
+ */
+export declare function resolveRelativeDateFilter<T extends {
+    operator: string;
+    value?: unknown;
+    valueTo?: unknown;
+}>(filter: T, now?: Date): T;