@lowdefy/blocks-table 0.0.0-experimental-20260929110023

package/dist/features/filtering/getFilteredKeys.js

@@ -0,0 +1,31 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import getConditionKeys from './getConditionKeys.js';
+import pruneCondition from './pruneCondition.js';
+const cache = new WeakMap();
+const NONE = new Set();
+// The columns a view filter actually constrains (complete conditions only), for the header's
+// filter icons. Cached by filter object: every header cell asks on every grid render.
+function getFilteredKeys(filter) {
+    if (!type.isObject(filter)) return NONE;
+    let keys = cache.get(filter);
+    if (!keys) {
+        keys = getConditionKeys(pruneCondition(filter));
+        cache.set(filter, keys);
+    }
+    return keys;
+}
+export default getFilteredKeys;

package/dist/features/filtering/getFilteringHeaderProps.js

@@ -0,0 +1,22 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import getFilteredKeys from './getFilteredKeys.js';
+function getFilteringHeaderProps({ col, state }) {
+    if (!getFilteredKeys(state.filter).has(col.key)) return {};
+    return {
+        'data-filtered': ''
+    };
+}
+export default getFilteringHeaderProps;

package/dist/features/filtering/getFilteringMenuItems.js

@@ -0,0 +1,42 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import getFilteredKeys from './getFilteredKeys.js';
+// Header menu items (the headerMenu extension point): open the column filter, clear it.
+function getFilteringMenuItems({ column, api }) {
+    if (!column.filterable) return [];
+    const items = [
+        {
+            key: 'filter',
+            label: 'Filter…',
+            section: 'filter',
+            onClick: ()=>api.actions.openColumnFilter({
+                    key: column.key
+                })
+        }
+    ];
+    if (getFilteredKeys(api.state.filter).has(column.key)) {
+        items.push({
+            key: 'clearFilter',
+            label: 'Clear filter',
+            section: 'filter',
+            onClick: ()=>api.actions.updateColumnFilter({
+                    key: column.key,
+                    condition: null
+                })
+        });
+    }
+    return items;
+}
+export default getFilteringMenuItems;

package/dist/features/filtering/getFilteringTableOptions.js

@@ -0,0 +1,33 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import isServerMode from './isServerMode.js';
+// Row-model inputs that come from config rather than state: the columns conditions and search
+// read, and the user `{ $user: path }` values resolve from. In server mode the request filters,
+// so TanStack's filtered row model passes the rows through.
+function getFilteringTableOptions({ config }) {
+    const columnsByKey = {};
+    config.columns.forEach((column)=>{
+        columnsByKey[column.key] = column;
+    });
+    return {
+        manualFiltering: isServerMode(config),
+        lowdefyFiltering: {
+            columns: config.columns,
+            columnsByKey,
+            user: config.user
+        }
+    };
+}
+export default getFilteringTableOptions;

package/dist/features/filtering/getGroupOperator.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+// 'and' or 'or' for a group condition, null for a leaf.
+function getGroupOperator(condition) {
+    if (!type.isObject(condition)) return null;
+    if (!type.isUndefined(condition.and)) return 'and';
+    if (!type.isUndefined(condition.or)) return 'or';
+    return null;
+}
+export default getGroupOperator;

package/dist/features/filtering/getOperatorLabel.js

@@ -0,0 +1,50 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ const LABELS = {
+    eq: 'is',
+    ne: 'is not',
+    in: 'is any of',
+    nin: 'is none of',
+    empty: 'is empty',
+    notEmpty: 'is not empty',
+    contains: 'contains',
+    notContains: 'does not contain',
+    startsWith: 'starts with',
+    endsWith: 'ends with',
+    gt: 'greater than',
+    gte: 'at least',
+    lt: 'less than',
+    lte: 'at most',
+    between: 'between',
+    before: 'before',
+    after: 'after',
+    within: 'within',
+    isTrue: 'is true',
+    isFalse: 'is false'
+};
+// Array columns (tags, people) read as "has": `in` is any of, `contains` has the value.
+const ARRAY_LABELS = {
+    in: 'has any of',
+    nin: 'has none of',
+    contains: 'has',
+    notContains: 'does not have',
+    eq: 'is exactly',
+    ne: 'is not exactly'
+};
+function getOperatorLabel({ op, family }) {
+    if (family === 'array' && ARRAY_LABELS[op]) return ARRAY_LABELS[op];
+    return LABELS[op] ?? op;
+}
+export default getOperatorLabel;

package/dist/features/filtering/getPlainTitle.js

@@ -0,0 +1,26 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import htmlToText from '@lowdefy/blocks-antd/table/htmlToText.js';
+import humanizeKey from '@lowdefy/blocks-antd/table/humanizeKey.js';
+// Column titles may hold HTML; menus, selects and labels show them as text. A column whose title
+// is empty (an actions column with `title: ''`) is named by its key there ("Actions"), so every
+// column the table lists has a label.
+function getPlainTitle(column) {
+    const title = type.isString(column.title) && column.title.includes('<') ? htmlToText(column.title) : String(column.title ?? '');
+    if (title.trim() !== '') return title;
+    return humanizeKey(column.key) || String(column.key);
+}
+export default getPlainTitle;

package/dist/features/filtering/getSearchColumns.js

@@ -0,0 +1,23 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import CELL_TYPE_FAMILIES from '@lowdefy/blocks-antd/table/cellTypeFamilies.js';
+// The columns `view.search` reads: the ones that declare `searchable: true`, or, when none do,
+// every visible column that shows data (action cells hold buttons, not text).
+function getSearchColumns({ columns, columnVisibility }) {
+    const declared = columns.filter((column)=>column.searchable === true);
+    if (declared.length > 0) return declared;
+    return columns.filter((column)=>columnVisibility[column.key] !== false && CELL_TYPE_FAMILIES[column.type] !== 'action');
+}
+export default getSearchColumns;

package/dist/features/filtering/getSearchKey.js

@@ -0,0 +1,19 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ // The words of a search as one comparable string: lowercased, single-spaced.
+function getSearchKey(search) {
+    return search.trim().toLowerCase().split(/\s+/).filter(Boolean).join(' ');
+}
+export default getSearchKey;

package/dist/features/filtering/getSearchText.js

@@ -0,0 +1,57 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import getCellText from '@lowdefy/blocks-antd/table/getCellText.js';
+import createAccessor from '../../core/createAccessor.js';
+// Formatting a cell's display text (numbers, dates, option labels) is the expensive part of a
+// search, and it only depends on the row and the searched columns. Each row's lowercased text is
+// kept per searched-column set, weakly by row object, so typing more of a search word only runs
+// `includes`, and unchanged rows keep their text across data updates. A set is identified by its
+// column objects: new column config (new objects) starts a new index.
+const indexes = new Map();
+function sameColumns(a, b) {
+    return a.length === b.length && a.every((column, i)=>column === b[i]);
+}
+function getIndex(columns) {
+    const signature = columns.map((column)=>column.key).join('\u0000');
+    let index = indexes.get(signature);
+    if (!index || !sameColumns(index.columns, columns)) {
+        index = {
+            columns,
+            accessors: columns.map((column)=>createAccessor(column.field)),
+            texts: new WeakMap()
+        };
+        indexes.set(signature, index);
+    }
+    return index;
+}
+// The lowercased display text of `row` across `columns`, one cell per line.
+function getSearchText({ columns, row }) {
+    const index = getIndex(columns);
+    let text = index.texts.get(row);
+    if (text === undefined) {
+        const parts = new Array(columns.length);
+        for(let i = 0; i < columns.length; i++){
+            parts[i] = getCellText({
+                column: columns[i],
+                value: index.accessors[i](row),
+                row
+            });
+        }
+        text = parts.join('\n').toLowerCase();
+        index.texts.set(row, text);
+    }
+    return text;
+}
+export default getSearchText;

package/dist/features/filtering/getTopLevelConditions.js

@@ -0,0 +1,25 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+// The conditions a view filter combines at the top: the items of a top-level `and`, or the filter
+// itself as the only item (a leaf or an `or` group).
+function getTopLevelConditions(filter) {
+    if (!type.isObject(filter)) return [];
+    if (type.isArray(filter.and)) return filter.and;
+    return [
+        filter
+    ];
+}
+export default getTopLevelConditions;

package/dist/features/filtering/getValueShape.js

@@ -0,0 +1,30 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ const SHAPES = {
+    empty: 'none',
+    notEmpty: 'none',
+    isTrue: 'none',
+    isFalse: 'none',
+    in: 'list',
+    nin: 'list',
+    between: 'range',
+    within: 'relative'
+};
+// What an operator's value looks like: none, a list, a [from, to] range, a relative date
+// `{ last | next, unit }`, or one scalar.
+function getValueShape(op) {
+    return SHAPES[op] ?? 'scalar';
+}
+export default getValueShape;

package/dist/features/filtering/handleFilterIndicatorClick.js

@@ -0,0 +1,25 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ // A click on a header's filter icon opens that column's filter instead of sorting.
+function handleFilterIndicatorClick(event, api) {
+    const button = event.target.closest('[data-lf-filter-indicator]');
+    if (!button || !api.contains(button)) return false;
+    const cell = button.closest('[data-lf-header]');
+    api.actions.openColumnFilter({
+        key: cell.dataset.colKey
+    });
+    return true;
+}
+export default handleFilterIndicatorClick;

package/dist/features/filtering/initFilter.js

@@ -0,0 +1,25 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import pickViewPart from '../../core/pickViewPart.js';
+function initFilter({ value, defaultView }) {
+    const filter = pickViewPart({
+        value,
+        defaultView,
+        key: 'filter'
+    });
+    return type.isObject(filter) ? filter : null;
+}
+export default initFilter;

package/dist/features/filtering/initSearch.js

@@ -0,0 +1,24 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import pickViewPart from '../../core/pickViewPart.js';
+import normalizeSearch from './normalizeSearch.js';
+function initSearch({ value, defaultView }) {
+    return normalizeSearch(pickViewPart({
+        value,
+        defaultView,
+        key: 'search'
+    }));
+}
+export default initSearch;

package/dist/features/filtering/isColumnCondition.js

@@ -0,0 +1,22 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import getConditionKeys from './getConditionKeys.js';
+// A top-level condition belongs to a column's filter when it references that column only. Mixed
+// conditions (an `or` across columns from the filter builder) belong to no single column.
+function isColumnCondition({ condition, key }) {
+    const keys = getConditionKeys(condition);
+    return keys.size === 1 && keys.has(key);
+}
+export default isColumnCondition;

package/dist/features/filtering/isCompleteLeaf.js

@@ -0,0 +1,45 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+import isEmptyValue from '@lowdefy/blocks-antd/table/isEmptyValue.js';
+const NO_VALUE_OPS = new Set([
+    'empty',
+    'notEmpty',
+    'isTrue',
+    'isFalse'
+]);
+const WITHIN_UNITS = new Set([
+    'day',
+    'week',
+    'month',
+    'year'
+]);
+function isCompleteWithin(value) {
+    if (!type.isObject(value) || !WITHIN_UNITS.has(value.unit)) return false;
+    return type.isNumber(value.last) || type.isNumber(value.next);
+}
+// A view filter leaf someone is still building (no column, or an operator without its value yet)
+// constrains nothing: the filter builder writes the condition to the view while it is edited, and
+// a half-built `in: []` must not hide every row.
+function isCompleteLeaf(leaf) {
+    if (type.isNone(leaf.key) || !type.isString(leaf.op)) return false;
+    if (NO_VALUE_OPS.has(leaf.op)) return true;
+    if (leaf.op === 'within') return isCompleteWithin(leaf.value);
+    if (leaf.op === 'between') {
+        return type.isArray(leaf.value) && leaf.value.length === 2 && leaf.value.some((bound)=>!isEmptyValue(bound));
+    }
+    return !isEmptyValue(leaf.value);
+}
+export default isCompleteLeaf;

package/dist/features/filtering/isServerMode.js

@@ -0,0 +1,21 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+// Server mode (D9, `config.server` from normalizeServerData): the request filters, sorts and
+// searches; the table only keeps the state.
+function isServerMode(config) {
+    return !type.isNone(config.server);
+}
+export default isServerMode;

package/dist/features/filtering/normalizeSearch.js

@@ -0,0 +1,21 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/ import { type } from '@lowdefy/helpers';
+// An empty search is no search: the value holds null rather than ''.
+function normalizeSearch(search) {
+    if (!type.isString(search) || search.trim() === '') return null;
+    return search;
+}
+export default normalizeSearch;