@svgrid/enterprise 2.6.1 → 2.6.2

package/dist/advanced-filter/expr-columns-from-grid.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Derive the expression layer's column metadata from a live grid.
+ *
+ * Saves every consumer from hand-writing an `ExprColumn[]` that mirrors their
+ * column defs and then drifting from it.
+ */
+import type { ExprColumn } from '../expressions/expression-columns';
+/** Grid columns as `api.getColumns()` reports them. */
+type GridColumnInfo = {
+    id: string;
+    field?: string;
+    header: string;
+    visible: boolean;
+    editorType?: string;
+};
+export type ExprColumnsOptions = {
+    /** Include columns currently hidden by the user. Default false. */
+    includeHidden?: boolean;
+};
+/**
+ * Build `ExprColumn[]` from a grid API.
+ *
+ * Typed loosely on purpose: `SvGridApi` is generic over features and row type,
+ * and this only needs `getColumns()`. Taking the concrete generic here would
+ * force every caller to thread both parameters through for no benefit.
+ */
+export declare function exprColumnsFromGrid(api: {
+    getColumns(): ReadonlyArray<GridColumnInfo>;
+}, options?: ExprColumnsOptions): ExprColumn[];
+export {};

package/dist/advanced-filter/expr-columns-from-grid.js

@@ -0,0 +1,44 @@
+/**
+ * Columns the grid renders but a user cannot meaningfully filter on. These are
+ * structural (a checkbox gutter, a row-number gutter) rather than data.
+ */
+const NON_DATA_IDS = new Set(['__select', '__selection', '__rowNumber', '__autoGroup', '__actions']);
+/** Map a grid editorType onto the coarse type the operator catalogue uses. */
+function toExprType(editorType) {
+    switch (editorType) {
+        case 'number':
+            return 'number';
+        case 'date':
+            return 'date';
+        case 'datetime':
+            return 'datetime';
+        case 'checkbox':
+            return 'boolean';
+        default:
+            return 'text';
+    }
+}
+/**
+ * Build `ExprColumn[]` from a grid API.
+ *
+ * Typed loosely on purpose: `SvGridApi` is generic over features and row type,
+ * and this only needs `getColumns()`. Taking the concrete generic here would
+ * force every caller to thread both parameters through for no benefit.
+ */
+export function exprColumnsFromGrid(api, options = {}) {
+    const out = [];
+    for (const col of api.getColumns()) {
+        if (NON_DATA_IDS.has(col.id))
+            continue;
+        if (!options.includeHidden && !col.visible)
+            continue;
+        out.push({
+            id: col.id,
+            // Fall back to the id so a column with no header is still addressable
+            // in the `[Bracketed Name]` reference syntax.
+            name: col.header || col.id,
+            type: toExprType(col.editorType),
+        });
+    }
+    return out;
+}

package/dist/advanced-filter-enable.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Enable the advanced filter. Call once (installEnterprise does it for you),
+ * after which `api.setAdvancedFilter(expr)` actually filters rows.
+ */
+export declare function enableAdvancedFilter(): void;

package/dist/advanced-filter-enable.js

@@ -0,0 +1,35 @@
+/**
+ * Advanced Filter (Pro): register the expression compiler with the grid.
+ *
+ * Same shape as `pivot-enable.ts` - idempotent flag, register, soft-gate nudge.
+ * The grid owns the filter state and the pipeline slot; this supplies the
+ * compiler that turns an expression into a row predicate.
+ */
+import { registerAdvancedFilterEngine } from '@svgrid/grid';
+import { isLicenseKeySet } from './license';
+import { emitUnlicensedNudge } from './watermark';
+import { compilePredicate } from './expressions/compile';
+let enabled = false;
+const advancedFilterEngine = (expr, ctx) => {
+    // The grid treats null as "do not filter" and never surfaces a partially
+    // applied predicate, so swallowing here is safe and is the fail-open half of
+    // the contract documented on AdvancedFilterEngine.
+    try {
+        return compilePredicate(expr, ctx);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Enable the advanced filter. Call once (installEnterprise does it for you),
+ * after which `api.setAdvancedFilter(expr)` actually filters rows.
+ */
+export function enableAdvancedFilter() {
+    if (enabled)
+        return;
+    enabled = true;
+    registerAdvancedFilterEngine(advancedFilterEngine);
+    if (!isLicenseKeySet())
+        emitUnlicensedNudge();
+}