@lowdefy/blocks-table 0.0.0-experimental-20260929110023

package/dist/features/filtering/createSetSearch.js

@@ -0,0 +1,29 @@
+/*
+  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 normalizeSearch from './normalizeSearch.js';
+// Block method and action `setSearch(text)`: sets `view.search`; an empty string or null clears
+// it.
+function createSetSearch(api) {
+    return function setSearch(text) {
+        if (!type.isNone(text) && !type.isString(text)) {
+            throw new Error(`Table setSearch requires a string or null. Received ${JSON.stringify(text)}.`);
+        }
+        api.actions.applyFiltering({
+            search: normalizeSearch(text)
+        });
+    };
+}
+export default createSetSearch;

package/dist/features/filtering/createUpdateColumnFilter.js

@@ -0,0 +1,29 @@
+/*
+  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 setColumnFilter from './setColumnFilter.js';
+// Action `updateColumnFilter({ key, condition })`: the column filter popover's write path. The
+// column's conditions in `view.filter` are replaced; null removes them.
+function createUpdateColumnFilter(api) {
+    return function updateColumnFilter({ key, condition }) {
+        api.actions.applyFiltering({
+            filter: (filter)=>setColumnFilter({
+                    filter,
+                    key,
+                    condition
+                })
+        });
+    };
+}
+export default createUpdateColumnFilter;

package/dist/features/filtering/defaultRelativeDate.js

@@ -0,0 +1,20 @@
+/*
+  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 value a `within` condition starts with, so choosing the operator already filters.
+const defaultRelativeDate = {
+    last: 7,
+    unit: 'day'
+};
+export default defaultRelativeDate;

package/dist/features/filtering/filterRowModel.js

@@ -0,0 +1,66 @@
+/*
+  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 createRowTest from './createRowTest.js';
+import getFilterResultKey from './getFilterResultKey.js';
+import getFilterResults from './getFilterResults.js';
+import getSearchColumns from './getSearchColumns.js';
+import pruneCondition from './pruneCondition.js';
+// Client-side filtering (D6): `view.filter` compiled once into a row test, `view.search` matched
+// against the searched columns' display text. A filter or search applied through the table
+// (applyFiltering) arrives prepared as one flag per row, so this only gathers the kept rows; one
+// set through the value (SetState, defaultView) is tested here. Kept rows keep their TanStack Row
+// objects, so sorting and the body see the same rows as before, only fewer.
+function filterRowModel(table) {
+    const preFiltered = table.getPreFilteredRowModel();
+    const source = preFiltered.rows;
+    const { filter, search } = table.options.state;
+    const context = table.options.lowdefyFiltering;
+    const condition = pruneCondition(filter);
+    const searchColumns = getSearchColumns({
+        columns: context.columns,
+        columnVisibility: table.atoms.columnVisibility.get()
+    });
+    const { key } = getFilterResultKey({
+        condition,
+        search
+    });
+    const prepared = getFilterResults({
+        rows: source,
+        context,
+        searchColumns
+    }).get(key);
+    const test = prepared ? null : createRowTest({
+        condition,
+        search,
+        context,
+        searchColumns
+    });
+    if (!prepared && test === null) return preFiltered;
+    const rows = [];
+    const rowsById = {};
+    for(let i = 0; i < source.length; i++){
+        const row = source[i];
+        const kept = prepared ? prepared.flags[i] === 1 : test(row.original);
+        if (!kept) continue;
+        rows.push(row);
+        rowsById[row.id] = row;
+    }
+    return {
+        rows,
+        flatRows: rows,
+        rowsById
+    };
+}
+export default filterRowModel;

package/dist/features/filtering/filtering.css

@@ -0,0 +1,151 @@
+/*
+  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.
+*/
+
+/* Column filter popover, filter builder and the header filter icon. */
+
+@layer components {
+  .lf-table-filter-indicator {
+    order: 1;
+    color: var(--ant-color-primary, #1677ff);
+  }
+
+  .lf-table-column-filter {
+    width: 300px;
+    max-width: calc(100vw - 32px);
+  }
+
+  .lf-table-column-filter:has(.lf-filter-builder) {
+    width: 480px;
+  }
+
+  .lf-filter-simple {
+    display: flex;
+    flex-direction: column;
+    gap: var(--ant-margin-xs, 8px);
+  }
+
+  .lf-filter-range {
+    flex-direction: row;
+    align-items: center;
+  }
+
+  .lf-filter-range .ant-input-number {
+    flex: 1;
+    width: auto;
+  }
+
+  .lf-filter-range-dash {
+    color: var(--ant-color-text-tertiary, rgba(0, 0, 0, 0.45));
+  }
+
+  .lf-filter-options-actions {
+    display: flex;
+    justify-content: space-between;
+    margin: 2px 0;
+  }
+
+  .lf-filter-options-actions .ant-btn {
+    padding: 0;
+  }
+
+  .lf-filter-options-list {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    max-height: 240px;
+    overflow-y: auto;
+  }
+
+  .lf-filter-options-list .ant-checkbox-wrapper {
+    margin: 0;
+    padding: 2px 0;
+  }
+
+  .lf-filter-options-empty {
+    padding: var(--ant-padding-xs, 8px) 0;
+    color: var(--ant-color-text-tertiary, rgba(0, 0, 0, 0.45));
+  }
+
+  .lf-filter-builder {
+    display: flex;
+    flex-direction: column;
+    gap: var(--ant-margin-xs, 8px);
+  }
+
+  .lf-filter-group {
+    display: flex;
+    flex-direction: column;
+    gap: var(--ant-margin-xxs, 4px);
+  }
+
+  .lf-filter-group[data-depth='2'],
+  .lf-filter-group[data-depth='3'] {
+    padding: var(--ant-padding-xs, 8px);
+    background: var(--ant-color-fill-quaternary, rgba(0, 0, 0, 0.02));
+    border: 1px solid var(--ant-color-border-secondary, #f0f0f0);
+    border-radius: var(--ant-border-radius, 6px);
+  }
+
+  .lf-filter-group-header {
+    display: flex;
+    align-items: center;
+    gap: var(--ant-margin-xs, 8px);
+  }
+
+  .lf-filter-group-header .lf-filter-remove {
+    margin-left: auto;
+  }
+
+  .lf-filter-group-label {
+    color: var(--ant-color-text-secondary, rgba(0, 0, 0, 0.65));
+  }
+
+  .lf-filter-group-items {
+    display: flex;
+    flex-direction: column;
+    gap: var(--ant-margin-xxs, 4px);
+  }
+
+  .lf-filter-group-actions {
+    display: flex;
+    gap: var(--ant-margin-xs, 8px);
+  }
+
+  .lf-filter-group-actions .ant-btn {
+    padding: 0;
+  }
+
+  .lf-filter-leaf {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--ant-margin-xxs, 4px);
+  }
+
+  .lf-filter-column,
+  .lf-filter-operator {
+    min-width: 110px;
+  }
+
+  .lf-filter-value {
+    flex: 1;
+    min-width: 140px;
+  }
+
+  .lf-filter-leaf .lf-filter-remove {
+    margin-left: auto;
+  }
+}

package/dist/features/filtering/filteringFeature.js

@@ -0,0 +1,82 @@
+/*
+  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 createApplyFiltering from './createApplyFiltering.js';
+import createClearFilters from './createClearFilters.js';
+import createCloseColumnFilter from './createCloseColumnFilter.js';
+import createConditionFilteredRowModel from './createConditionFilteredRowModel.js';
+import createOpenColumnFilter from './createOpenColumnFilter.js';
+import createSetFilter from './createSetFilter.js';
+import createSetSearch from './createSetSearch.js';
+import createUpdateColumnFilter from './createUpdateColumnFilter.js';
+import FilterIndicator from './FilterIndicator.js';
+import filteringToValue from './filteringToValue.js';
+import getFilteringHeaderProps from './getFilteringHeaderProps.js';
+import getFilteringMenuItems from './getFilteringMenuItems.js';
+import getFilteringTableOptions from './getFilteringTableOptions.js';
+import handleFilterIndicatorClick from './handleFilterIndicatorClick.js';
+import initFilter from './initFilter.js';
+import initSearch from './initSearch.js';
+import useFilteringState from './useFilteringState.js';
+import './filtering.css';
+// `view.filter` (a Condition) and `view.search` (text), applied client-side before sorting
+// (D6, D10.7). Writes go through applyFiltering: the rows are tested in time slices, then the
+// state applies in a transition, so the edit paints at once and the previous rows stay, dimmed,
+// until the filtered rows land. In server mode the state only feeds the request.
+const filteringFeature = {
+    name: 'filtering',
+    tableFeatures: {
+        filteredRowModel: createConditionFilteredRowModel()
+    },
+    viewKeys: [
+        'filter',
+        'search'
+    ],
+    slices: {
+        filter: {
+            init: initFilter,
+            cause: 'filter',
+            transition: true
+        },
+        search: {
+            init: initSearch,
+            cause: 'search',
+            transition: true
+        }
+    },
+    tableOptions: getFilteringTableOptions,
+    toValue: filteringToValue,
+    actions: {
+        applyFiltering: createApplyFiltering,
+        openColumnFilter: createOpenColumnFilter,
+        closeColumnFilter: createCloseColumnFilter,
+        updateColumnFilter: createUpdateColumnFilter,
+        setSearch: createSetSearch
+    },
+    methods: {
+        setFilter: createSetFilter,
+        clearFilters: createClearFilters,
+        setSearch: createSetSearch
+    },
+    headerParts: [
+        FilterIndicator
+    ],
+    headerCellProps: getFilteringHeaderProps,
+    headerMenuItems: getFilteringMenuItems,
+    gridHandlers: {
+        click: handleFilterIndicatorClick
+    },
+    useFeature: useFilteringState
+};
+export default filteringFeature;

package/dist/features/filtering/filteringToValue.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.
+*/ function filteringToValue({ state }) {
+    return {
+        view: {
+            filter: state.filter,
+            search: state.search
+        }
+    };
+}
+export default filteringToValue;

package/dist/features/filtering/formatFilterDate.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 { type } from '@lowdefy/helpers';
+// A picked day as a filter value: `YYYY-MM-DD` for date columns (compared by day), and the start
+// or end of that day as an ISO instant for datetime columns, so a range covers whole days.
+function formatFilterDate({ column, date, edge }) {
+    if (type.isNone(date)) return null;
+    if (column.type !== 'datetime') return date.format('YYYY-MM-DD');
+    const day = edge === 'end' ? date.endOf('day') : date.startOf('day');
+    return day.toISOString();
+}
+export default formatFilterDate;

package/dist/features/filtering/getColumnConditions.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 getTopLevelConditions from './getTopLevelConditions.js';
+import isColumnCondition from './isColumnCondition.js';
+// The top-level conditions of a view filter that make up one column's filter.
+function getColumnConditions({ filter, key }) {
+    return getTopLevelConditions(filter).filter((condition)=>isColumnCondition({
+            condition,
+            key
+        }));
+}
+export default getColumnConditions;

package/dist/features/filtering/getConditionKeys.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 getGroupOperator from './getGroupOperator.js';
+function collect(condition, keys) {
+    const operator = getGroupOperator(condition);
+    if (operator === null) {
+        if (type.isObject(condition) && !type.isNone(condition.key)) keys.add(condition.key);
+        return;
+    }
+    (type.isArray(condition[operator]) ? condition[operator] : []).forEach((child)=>collect(child, keys));
+}
+// Every column key a condition's leaves reference.
+function getConditionKeys(condition) {
+    const keys = new Set();
+    collect(condition, keys);
+    return keys;
+}
+export default getConditionKeys;

package/dist/features/filtering/getDistinctOptions.js

@@ -0,0 +1,52 @@
+/*
+  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';
+import createAccessor from '../../core/createAccessor.js';
+const LIMIT = 1000;
+// Records (people, relations) filter by their id, the way the condition compares them.
+function toOption(item) {
+    if (!type.isObject(item)) return {
+        value: item,
+        label: String(item)
+    };
+    const value = item._id ?? item.id ?? item.value ?? item.name ?? item.label;
+    return {
+        value,
+        label: String(item.name ?? item.label ?? item.title ?? value)
+    };
+}
+// A column's distinct values as filter options, for option-style columns without declared
+// `options` (tags, people, statuses from data). Array values count each item. Capped, so a column
+// of unique values does not build a 100k-item list.
+function getDistinctOptions({ rows, column }) {
+    const accessor = createAccessor(column.field);
+    const seen = new Map();
+    for(let i = 0; i < rows.length && seen.size < LIMIT; i++){
+        const value = accessor(rows[i].original);
+        const items = type.isArray(value) ? value : [
+            value
+        ];
+        items.forEach((item)=>{
+            if (isEmptyValue(item)) return;
+            const option = toOption(item);
+            if (!seen.has(option.value)) seen.set(option.value, option);
+        });
+    }
+    return [
+        ...seen.values()
+    ].sort((a, b)=>a.label.localeCompare(b.label));
+}
+export default getDistinctOptions;

package/dist/features/filtering/getFilterKind.js

@@ -0,0 +1,37 @@
+/*
+  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 CELL_TYPE_FAMILIES from '@lowdefy/blocks-antd/table/cellTypeFamilies.js';
+const OPTION_TYPES = new Set([
+    'tag',
+    'tags',
+    'status',
+    'people'
+]);
+const KIND_BY_FAMILY = {
+    text: 'text',
+    number: 'number',
+    date: 'date',
+    boolean: 'boolean',
+    array: 'options'
+};
+// Which simple editor the column filter popover shows: a searchable value list (enums and
+// arrays), text operators, a number range, a date range or relative date, yes/no, or empty/not
+// empty for anything else.
+function getFilterKind(column) {
+    if (!type.isNone(column.options) || OPTION_TYPES.has(column.type)) return 'options';
+    return KIND_BY_FAMILY[CELL_TYPE_FAMILIES[column.type]] ?? 'presence';
+}
+export default getFilterKind;

package/dist/features/filtering/getFilterResultKey.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 getSearchKey from './getSearchKey.js';
+// Identifies a filter result: the complete condition and the search words.
+function getFilterResultKey({ condition, search }) {
+    const filterKey = JSON.stringify(condition);
+    const searchKey = search === null ? '' : getSearchKey(search);
+    return {
+        key: `${filterKey}\u0000${searchKey}`,
+        filterKey,
+        searchKey
+    };
+}
+export default getFilterResultKey;

package/dist/features/filtering/getFilterResults.js

@@ -0,0 +1,53 @@
+/*
+  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 MAX_RESULTS = 16;
+// Filter results prepared ahead of applying a filter or search (see prepareFilterResult): one
+// flag per row, kept weakly per rows array, for one filter context (columns, user) and one
+// searched-column set at a time.
+const entries = new WeakMap();
+function sameColumns(a, b) {
+    return a.length === b.length && a.every((column, i)=>column === b[i]);
+}
+function getFilterResults({ rows, context, searchColumns }) {
+    let entry = entries.get(rows);
+    if (!entry || entry.context !== context || !sameColumns(entry.searchColumns, searchColumns)) {
+        entry = {
+            context,
+            searchColumns,
+            results: new Map()
+        };
+        entries.set(rows, entry);
+    }
+    return {
+        get: (key)=>entry.results.get(key),
+        set: (key, value)=>{
+            if (entry.results.size >= MAX_RESULTS) {
+                entry.results.delete(entry.results.keys().next().value);
+            }
+            entry.results.set(key, value);
+        },
+        // The closest earlier result this one narrows: same filter, a search this one extends
+        // (typing on). Rows it dropped cannot match.
+        narrowest: ({ filterKey, searchKey })=>{
+            let best = null;
+            entry.results.forEach((value)=>{
+                if (value.filterKey !== filterKey || !searchKey.startsWith(value.searchKey)) return;
+                if (best === null || value.searchKey.length > best.searchKey.length) best = value;
+            });
+            return best?.flags ?? null;
+        }
+    };
+}
+export default getFilterResults;