@lowdefy/blocks-table 0.0.0-experimental-20260929110023

package/dist/features/toolbar/countConditions.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 number of leaf conditions in a filter, for the Filter button's count.
+function countConditions(condition) {
+    if (!type.isObject(condition)) return 0;
+    const group = condition.and ?? condition.or;
+    if (type.isArray(group)) {
+        return group.reduce((total, child)=>total + countConditions(child), 0);
+    }
+    return 1;
+}
+export default countConditions;

package/dist/features/toolbar/formatRecordCount.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.
+*/ const numberFormat = new Intl.NumberFormat();
+function formatRecordCount(count) {
+    return `${numberFormat.format(count)} ${count === 1 ? 'row' : 'rows'}`;
+}
+export default formatRecordCount;

package/dist/features/toolbar/getQuickFilterValues.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 getRootConditions from './getRootConditions.js';
+import isQuickFilterLeaf from './isQuickFilterLeaf.js';
+// The values a quick filter chip has checked: its column's top-level `in` leaf.
+function getQuickFilterValues({ filter, key }) {
+    const leaf = getRootConditions(filter).find((condition)=>isQuickFilterLeaf({
+            condition,
+            key
+        }));
+    return leaf?.value ?? [];
+}
+export default getQuickFilterValues;

package/dist/features/toolbar/getRootConditions.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 ANDed at the top of a filter: the items of a root `and` group, or the filter
+// itself when it is a single leaf or an `or` group.
+function getRootConditions(filter) {
+    if (!type.isObject(filter)) return [];
+    if (type.isArray(filter.and)) return filter.and;
+    return [
+        filter
+    ];
+}
+export default getRootConditions;

package/dist/features/toolbar/handleToolbarKeyDown.js

@@ -0,0 +1,28 @@
+/*
+  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.
+*/ // Cmd/Ctrl+F while focus is in the table focuses its search (find in view, as in Airtable). With
+// no search box the browser's own find runs.
+function handleToolbarKeyDown(event, api) {
+    if (!(event.metaKey || event.ctrlKey) || event.altKey || event.shiftKey) return false;
+    if (event.key !== 'f' && event.key !== 'F') return false;
+    const input = api.toolbarSearchRef.current;
+    if (!input) return false;
+    event.preventDefault();
+    input.focus({
+        cursor: 'all'
+    });
+    return true;
+}
+export default handleToolbarKeyDown;

package/dist/features/toolbar/isDefaultSorting.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 initSorting from '../sorting/initSorting.js';
+// Whether the sort is the one `defaultView` starts with, which the Sort button does not count.
+function isDefaultSorting({ config, sorting }) {
+    const defaults = initSorting({
+        value: null,
+        defaultView: config.defaultView,
+        config
+    });
+    if (defaults.length !== sorting.length) return false;
+    return defaults.every((entry, index)=>entry.id === sorting[index].id && entry.desc === sorting[index].desc);
+}
+export default isDefaultSorting;

package/dist/features/toolbar/isQuickFilterLeaf.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.
+*/ import { type } from '@lowdefy/helpers';
+// A quick filter chip owns one top-level `in` leaf on its column.
+function isQuickFilterLeaf({ condition, key }) {
+    return type.isObject(condition) && condition.key === key && condition.op === 'in' && type.isArray(condition.value);
+}
+export default isQuickFilterLeaf;

package/dist/features/toolbar/moveItem.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 copy of the list with the item at `from` moved to `to`.
+function moveItem({ items, from, to }) {
+    if (to < 0 || to >= items.length) return items;
+    const next = [
+        ...items
+    ];
+    const [item] = next.splice(from, 1);
+    next.splice(to, 0, item);
+    return next;
+}
+export default moveItem;

package/dist/features/toolbar/needsToolbar.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';
+// The toolbar loads when it is configured or a toolbar slot has blocks (as useToolbar shows it).
+function needsToolbar({ content, properties }) {
+    if (content?.toolbarStart || content?.toolbarEnd) return true;
+    return properties.toolbar === true || type.isObject(properties.toolbar);
+}
+export default needsToolbar;

package/dist/features/toolbar/normalizeToolbar.js

@@ -0,0 +1,61 @@
+/*
+  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 validateQuickFilters from './validateQuickFilters.js';
+const ITEMS = [
+    'views',
+    'search',
+    'filter',
+    'sort',
+    'group',
+    'columns',
+    'density',
+    'export'
+];
+// The toolbar is off by default (D15). `true` turns on every item; an object turns on the items
+// set to true, plus quick filter chips for the listed column keys. A configured toolbar always
+// shows the record count.
+function normalizeToolbar({ toolbar, columnsByKey }) {
+    if (toolbar === true) {
+        return Object.fromEntries([
+            ...ITEMS.map((item)=>[
+                    item,
+                    true
+                ]),
+            [
+                'quickFilters',
+                []
+            ],
+            [
+                'count',
+                true
+            ]
+        ]);
+    }
+    if (!type.isObject(toolbar)) return null;
+    const normalized = {
+        count: true,
+        quickFilters: type.isArray(toolbar.quickFilters) ? toolbar.quickFilters.filter((key)=>type.isString(key)) : []
+    };
+    ITEMS.forEach((item)=>{
+        normalized[item] = toolbar[item] === true;
+    });
+    validateQuickFilters({
+        keys: normalized.quickFilters,
+        columnsByKey
+    });
+    return normalized;
+}
+export default normalizeToolbar;

package/dist/features/toolbar/setQuickFilterValues.js

@@ -0,0 +1,35 @@
+/*
+  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 getRootConditions from './getRootConditions.js';
+import isQuickFilterLeaf from './isQuickFilterLeaf.js';
+// The filter with a quick filter chip's leaf replaced: `{ key, op: 'in', value }` ANDed with the
+// rest of the filter, or removed when no values are checked. Other conditions are kept as they
+// are; a filter left with no conditions is null.
+function setQuickFilterValues({ filter, key, values }) {
+    const conditions = getRootConditions(filter).filter((condition)=>!isQuickFilterLeaf({
+            condition,
+            key
+        }));
+    if (values.length > 0) conditions.push({
+        key,
+        op: 'in',
+        value: values
+    });
+    if (conditions.length === 0) return null;
+    return {
+        and: conditions
+    };
+}
+export default setQuickFilterValues;

package/dist/features/toolbar/toolbar.css

@@ -0,0 +1,185 @@
+/*
+  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 toolbar, view tabs and their popovers. Popovers render in document.body, so their rules are
+   not scoped under .lf-table. */
+
+@layer components {
+  .lf-table-toolbar {
+    display: flex;
+    flex-direction: column;
+    border-bottom: 1px solid var(--lf-border);
+  }
+
+  .lf-table-toolbar-row {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: space-between;
+    gap: 8px;
+    padding: 8px;
+  }
+
+  .lf-table-toolbar-start,
+  .lf-table-toolbar-end {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 8px;
+    min-width: 0;
+  }
+
+  .lf-table-toolbar-search {
+    display: inline-flex;
+    width: 220px;
+    max-width: 100%;
+  }
+
+  /* The count of set conditions or levels inside a toolbar button (and a quick filter's picked
+     values): a small chip in the primary tint, part of the button. The text is the primary colour
+     mixed toward the text base, readable on the tint in light and dark themes. */
+  .lf-table-toolbar-count {
+    display: inline-block;
+    box-sizing: border-box;
+    min-width: 16px;
+    padding: 0 4px;
+    color: color-mix(
+      in srgb,
+      var(--ant-color-primary, #1677ff) 60%,
+      var(--ant-color-text-base, #000)
+    );
+    font-size: 11px;
+    font-weight: var(--ant-font-weight-strong, 600);
+    font-variant-numeric: tabular-nums;
+    line-height: 16px;
+    text-align: center;
+    background: var(--ant-color-primary-bg, #e6f4ff);
+    border-radius: 8px;
+  }
+
+  .lf-table-quick-filter-options {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+    max-height: 320px;
+    overflow: auto;
+  }
+
+  .lf-table-record-count {
+    color: var(--ant-color-text-secondary, rgba(0, 0, 0, 0.65));
+    font-size: var(--ant-font-size-sm, 12px);
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap;
+  }
+
+  .lf-table-toolbar-popover {
+    min-width: 280px;
+    max-width: min(560px, 90vw);
+  }
+
+  .lf-table-toolbar-list {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+  }
+
+  .lf-table-toolbar-list-item {
+    display: flex;
+    align-items: center;
+    gap: 4px;
+  }
+
+  .lf-table-toolbar-list-title {
+    flex: 1;
+    min-width: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+
+  .lf-table-toolbar-list-empty {
+    color: var(--ant-color-text-tertiary, rgba(0, 0, 0, 0.45));
+  }
+
+  .lf-table-toolbar-list-add {
+    width: 100%;
+    margin-top: 4px;
+  }
+
+  .lf-table-views {
+    padding: 0 8px;
+  }
+
+  .lf-table-views > .ant-tabs-nav {
+    margin: 0;
+  }
+
+  .lf-table-view-tab {
+    display: inline-flex;
+    align-items: center;
+    gap: 6px;
+  }
+
+  .lf-table-view-tab-count {
+    padding: 0 6px;
+    border-radius: 8px;
+    background: var(--ant-color-fill-secondary, rgba(0, 0, 0, 0.06));
+    color: var(--ant-color-text-secondary, rgba(0, 0, 0, 0.65));
+    font-size: 11px;
+    line-height: 18px;
+    font-variant-numeric: tabular-nums;
+  }
+
+  .lf-table-view-dirty {
+    width: 6px;
+    height: 6px;
+    border-radius: 50%;
+    background: var(--ant-color-warning, #faad14);
+  }
+
+  .lf-table-view-menu {
+    display: inline-flex;
+    align-items: center;
+    padding: 0 2px;
+    border: 0;
+    border-radius: var(--ant-border-radius-sm, 4px);
+    background: transparent;
+    color: inherit;
+    cursor: pointer;
+  }
+
+  .lf-table-view-menu:hover {
+    background: var(--ant-color-fill-secondary, rgba(0, 0, 0, 0.06));
+  }
+
+  .lf-table-view-actions {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+  }
+
+  .lf-table-view-actions-label {
+    color: var(--ant-color-text-secondary, rgba(0, 0, 0, 0.65));
+    font-size: var(--ant-font-size-sm, 12px);
+  }
+
+  .lf-table-save-view {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    width: 220px;
+  }
+}

package/dist/features/toolbar/toolbarFeature.js

@@ -0,0 +1,27 @@
+/*
+  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 handleToolbarKeyDown from './handleToolbarKeyDown.js';
+import useToolbar from './useToolbar.js';
+// The toolbar above the grid (D7, off by default per D15). It holds no state of its own: every
+// control writes the view through the slices and actions the other features own (search and
+// filter, sorting, grouping, density, the column manager, export) and the saved views.
+const toolbarFeature = {
+    name: 'toolbar',
+    gridHandlers: {
+        keydown: handleToolbarKeyDown
+    },
+    useFeature: useToolbar
+};
+export default toolbarFeature;

package/dist/features/toolbar/useToolbar.js

@@ -0,0 +1,41 @@
+/*
+  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 React, { useRef } from 'react';
+import normalizeToolbar from './normalizeToolbar.js';
+import Toolbar from './Toolbar.js';
+// Blocks in the `toolbarStart` / `toolbarEnd` slots show the bar even without `toolbar`.
+const SLOTS_ONLY = {
+    ...normalizeToolbar({
+        toolbar: {},
+        columnsByKey: new Map()
+    }),
+    count: false
+};
+function useToolbar({ api, config }) {
+    const searchRef = useRef(null);
+    api.toolbarSearchRef = searchRef;
+    const { content } = api;
+    if (config.toolbar === null && !content.toolbarStart && !content.toolbarEnd) return null;
+    return {
+        regions: {
+            top: /*#__PURE__*/ React.createElement(Toolbar, {
+                api: api,
+                searchRef: searchRef,
+                toolbar: config.toolbar ?? SLOTS_ONLY
+            })
+        }
+    };
+}
+export default useToolbar;

package/dist/features/toolbar/validateQuickFilters.js

@@ -0,0 +1,28 @@
+/*
+  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.
+*/ // Quick filter keys are config: a chip for a column that does not exist, or cannot be filtered,
+// is a mistake to report, not to hide.
+function validateQuickFilters({ keys, columnsByKey }) {
+    keys.forEach((key)=>{
+        const column = columnsByKey.get(key);
+        if (!column) {
+            throw new Error(`Table toolbar.quickFilters: no column "${key}".`);
+        }
+        if (!column.filterable) {
+            throw new Error(`Table toolbar.quickFilters: column "${key}" is not filterable.`);
+        }
+    });
+}
+export default validateQuickFilters;

package/dist/features/transactions/applyTransactionToRows.js

@@ -0,0 +1,56 @@
+/*
+  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';
+// Applies a normalised transaction to a rows array without mutating it. Updated rows are new
+// objects (shallow-merged into the row with the same key); every other row keeps its identity,
+// so only touched rows re-render. Keys to remove may be given as rows or as key values.
+function applyTransactionToRows({ rows, transaction, getKey }) {
+    const { add, update, remove, addIndex } = transaction;
+    const updates = new Map();
+    update.forEach((row)=>updates.set(String(getKey(row)), row));
+    const removals = new Set(remove.map((entry)=>String(type.isObject(entry) ? getKey(entry) : entry)));
+    const changed = {
+        added: add.length,
+        updated: 0,
+        removed: 0
+    };
+    const next = [];
+    rows.forEach((row)=>{
+        const id = String(getKey(row));
+        if (removals.has(id)) {
+            changed.removed += 1;
+            return;
+        }
+        const patch = updates.get(id);
+        if (patch === undefined) {
+            next.push(row);
+            return;
+        }
+        changed.updated += 1;
+        next.push({
+            ...row,
+            ...patch
+        });
+    });
+    if (add.length > 0) {
+        const index = type.isUndefined(addIndex) ? next.length : Math.min(Math.max(addIndex, 0), next.length);
+        next.splice(index, 0, ...add);
+    }
+    return {
+        rows: next,
+        changed
+    };
+}
+export default applyTransactionToRows;