@lowdefy/blocks-table 0.0.0-experimental-20260929110023

package/dist/features/tree/treeFeature.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 handleTreeClick from './handleTreeClick.js';
+import handleTreeKeyDown from './handleTreeKeyDown.js';
+import TreeToggle from './TreeToggle.js';
+import useTreeData from './useTreeData.js';
+import useTreeItems from './useTreeItems.js';
+import './tree.css';
+// Client-mode trees (`tree: { childrenField }` or `{ parentField }`): rows are indented under
+// their parents with an expand chevron in the first data column; `expanded` in the value holds
+// the expanded row keys. With `tree.lazy`, expanding a row whose children are not loaded fires
+// `onRowExpand` and the app adds them to `data`.
+const treeFeature = {
+    name: 'tree',
+    useData: useTreeData,
+    useItems: useTreeItems,
+    cellLead: TreeToggle,
+    gridHandlers: {
+        click: handleTreeClick,
+        keydown: handleTreeKeyDown
+    }
+};
+export default treeFeature;

package/dist/features/tree/useTreeData.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 { useMemo } from 'react';
+import flattenTreeData from './flattenTreeData.js';
+// Nested `childrenField` rows are flattened before TanStack sees them; `parentField` rows are
+// already flat. The parents found while flattening feed the tree index (useTreeItems).
+function useTreeData({ api, config, data }) {
+    const childrenField = config.tree?.childrenField ?? null;
+    const flattened = useMemo(()=>childrenField ? flattenTreeData({
+            data,
+            childrenField,
+            getId: config.getId
+        }) : null, [
+        data,
+        childrenField,
+        config.getId
+    ]);
+    api.treeParents = flattened?.parentOf ?? null;
+    return flattened ? flattened.rows : data;
+}
+export default useTreeData;

package/dist/features/tree/useTreeItems.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 { useMemo, useRef } from 'react';
+import buildTreeIndex from './buildTreeIndex.js';
+import buildTreeItems from './buildTreeItems.js';
+import getDescendantIds from './getDescendantIds.js';
+import getExpandedIds from '../expansion/getExpandedIds.js';
+// Tree rows from the row model: the index (parents and children) rebuilds when data changes, the
+// display list when the filtered/sorted rows or the expanded keys change. `api.tree` is what
+// cascading selection and keyboard expansion read.
+function useTreeItems({ api, config, rows, state, table }) {
+    const { tree } = config;
+    const coreModel = table.getCoreRowModel();
+    const index = useMemo(()=>tree ? buildTreeIndex({
+            rows: coreModel.rows.map((row)=>row.original),
+            getId: config.getId,
+            parentField: tree.parentField,
+            parentOf: api.treeParents
+        }) : null, [
+        coreModel,
+        tree,
+        config.getId
+    ]);
+    const cache = useRef(new WeakMap());
+    const items = useMemo(()=>index ? buildTreeItems({
+            rows,
+            rowsById: coreModel.rowsById,
+            parentOf: index.parentOf,
+            childrenOf: index.childrenOf,
+            expandedIds: getExpandedIds(state.expanded),
+            hasChildrenField: tree.hasChildrenField,
+            cache: cache.current
+        }) : null, [
+        rows,
+        index,
+        state.expanded
+    ]);
+    api.tree = index ? {
+        ...index,
+        getDescendantIds: (id)=>getDescendantIds({
+                id,
+                childrenOf: index.childrenOf
+            })
+    } : null;
+    return items ? {
+        rows: items
+    } : null;
+}
+export default useTreeItems;

package/dist/features/views/compactView.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.
+*/ import { type } from '@lowdefy/helpers';
+import stableStringify from './stableStringify.js';
+import viewKeys from './viewKeys.js';
+// The parts of a view that differ from the table's default view. A stored view keeps only these,
+// so everything else follows config: a part the user never changed picks up a new default.
+function compactView({ view, defaults }) {
+    const compact = {};
+    viewKeys.forEach((key)=>{
+        const part = view?.[key];
+        if (type.isUndefined(part)) return;
+        if (stableStringify(part) === stableStringify(defaults?.[key])) return;
+        compact[key] = part;
+    });
+    return compact;
+}
+export default compactView;

package/dist/features/views/createViewsApi.js

@@ -0,0 +1,74 @@
+/*
+  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.
+*/ // `api.views`: the saved views, the active one, whether the current view differs from it, and
+// the tab actions. The app stores views; these only load them and fire the events (D7).
+function createViewsApi({ api, active, currentView, dirty, setActiveId, views }) {
+    function load(target) {
+        const current = api.getValue();
+        api.loadValue({
+            view: target.view,
+            selected: current.selected,
+            expanded: current.expanded
+        }, {
+            cause: 'view'
+        });
+    }
+    return {
+        active,
+        dirty,
+        items: views,
+        select (key) {
+            const target = views.find((view)=>view.key === key);
+            if (!target || target === active) return;
+            setActiveId(target.id);
+            api.pendingViewSelect = target.id;
+            load(target);
+        },
+        save () {
+            api.methods.triggerEvent({
+                name: 'onViewSave',
+                event: {
+                    view: currentView,
+                    id: active.id,
+                    title: active.title,
+                    shared: active.shared
+                }
+            });
+        },
+        saveAs ({ title, shared }) {
+            api.methods.triggerEvent({
+                name: 'onViewSave',
+                event: {
+                    view: currentView,
+                    title,
+                    shared: shared === true
+                }
+            });
+        },
+        discard () {
+            load(active);
+        },
+        remove (view) {
+            api.methods.triggerEvent({
+                name: 'onViewDelete',
+                event: {
+                    id: view.id
+                }
+            });
+        },
+        load
+    };
+}
+export default createViewsApi;

package/dist/features/views/decodeViewParam.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.
+*/ import { type } from '@lowdefy/helpers';
+// Reverses encodeViewParam. The query string is user input: anything that does not decode to an
+// object is no persisted view.
+function decodeViewParam(text) {
+    if (!type.isString(text) || text === '') return null;
+    try {
+        const base64 = text.replace(/-/g, '+').replace(/_/g, '/');
+        const binary = atob(base64.padEnd(base64.length + (4 - base64.length % 4) % 4, '='));
+        const bytes = Uint8Array.from(binary, (char)=>char.charCodeAt(0));
+        const payload = JSON.parse(new TextDecoder().decode(bytes));
+        return type.isObject(payload) ? payload : null;
+    } catch  {
+        return null;
+    }
+}
+export default decodeViewParam;

package/dist/features/views/encodeViewParam.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 persisted view payload as a URL-safe query value: base64url of its UTF-8 JSON, which stays
+// short and needs no percent-escaping.
+function encodeViewParam(payload) {
+    const bytes = new TextEncoder().encode(JSON.stringify(payload));
+    let binary = '';
+    bytes.forEach((byte)=>{
+        binary += String.fromCharCode(byte);
+    });
+    return btoa(binary).replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
+}
+export default encodeViewParam;

package/dist/features/views/findActiveView.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';
+import getViewKey from './getViewKey.js';
+// The active saved view: the requested id when it is still in the list, else the first (leftmost)
+// view, as tabbed index pages default to their first tab.
+function findActiveView({ views, id }) {
+    const key = type.isNone(id) ? null : getViewKey(id);
+    return views.find((view)=>view.key === key) ?? views[0] ?? null;
+}
+export default findActiveView;

package/dist/features/views/getStorageKey.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.
+*/ // localStorage keys are shared by the whole origin; the prefix keeps table views apart from
+// anything else the app stores.
+function getStorageKey(key) {
+    return `lowdefy-table:${key}`;
+}
+export default getStorageKey;

package/dist/features/views/getViewKey.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 { type } from '@lowdefy/helpers';
+// A saved view id as a stable string, for tabs, lookups and the persisted active view. Ids from a
+// MongoDB request arrive as `{ _oid: hex }` (the client's ObjectId form): the hex is the key, so
+// the id and its hex string find the same view. Other objects key by their JSON; String() would
+// make every object "[object Object]".
+function getViewKey(id) {
+    if (type.isObject(id)) {
+        if (type.isString(id._oid)) return id._oid;
+        return JSON.stringify(id);
+    }
+    return String(id);
+}
+export default getViewKey;

package/dist/features/views/getViewSliceDeps.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.
+*/ // Selection and expansion are not part of the view. Leaving them out of the dependencies keeps a
+// click on a checkbox from re-deriving the view.
+const NON_VIEW_SLICES = new Set([
+    'rowSelection',
+    'selectionMode',
+    'selectionView',
+    'expanded'
+]);
+// The state slices a view derives from, in a fixed order, for hook dependencies.
+function getViewSliceDeps(state) {
+    return Object.keys(state).filter((name)=>!NON_VIEW_SLICES.has(name)).map((name)=>state[name]);
+}
+export default getViewSliceDeps;

package/dist/features/views/isViewDirty.js

@@ -0,0 +1,34 @@
+/*
+  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 stableStringify from './stableStringify.js';
+import viewKeys from './viewKeys.js';
+// Search text and collapsed groups are how a user reads a view, not what the view is, so they
+// never make a saved view dirty.
+const IGNORED = new Set([
+    'search',
+    'collapsedGroups'
+]);
+// Whether the current view differs from a saved view. Both are resolved views; a part missing
+// from either is the default view's part, so `sort: []` and no sort compare equal when the
+// default has no sort.
+function isViewDirty({ current, saved, defaults }) {
+    return viewKeys.some((key)=>{
+        if (IGNORED.has(key)) return false;
+        const a = current?.[key] ?? defaults?.[key] ?? null;
+        const b = saved?.[key] ?? defaults?.[key] ?? null;
+        return stableStringify(a) !== stableStringify(b);
+    });
+}
+export default isViewDirty;

package/dist/features/views/mountViewValue.js

@@ -0,0 +1,36 @@
+/*
+  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 findActiveView from './findActiveView.js';
+import normalizeViews from './normalizeViews.js';
+import readMountPayload from './readMountPayload.js';
+// `mountValue` for a table mounting without a value: the persisted view first (the user's last
+// view), then the active saved view.
+function mountViewValue({ config, properties }) {
+    const persisted = readMountPayload({
+        config
+    });
+    if (persisted !== null) return {
+        view: persisted.view
+    };
+    const active = findActiveView({
+        views: normalizeViews(properties.views),
+        id: properties.activeView
+    });
+    if (active === null) return null;
+    return {
+        view: active.view
+    };
+}
+export default mountViewValue;

package/dist/features/views/needsViews.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';
+// Saved views load with `persist`, with a `views` property (views may arrive later from a
+// request, so the key alone counts) and with the toolbar's view tabs.
+function needsViews({ properties }) {
+    if (!type.isNone(properties.persist)) return true;
+    if (!type.isUndefined(properties.views)) return true;
+    return properties.toolbar === true || properties.toolbar?.views === true;
+}
+export default needsViews;

package/dist/features/views/normalizePersist.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 { type } from '@lowdefy/helpers';
+// `persist: { key, storage }`, off unless set (D6, D15).
+function normalizePersist(persist) {
+    if (type.isNone(persist)) return null;
+    if (!type.isObject(persist) || !type.isString(persist.key) || persist.key === '') {
+        throw new Error(`Table persist requires a "key" string. Received ${JSON.stringify(persist)}.`);
+    }
+    return {
+        key: persist.key,
+        storage: persist.storage === 'url' ? 'url' : 'local'
+    };
+}
+export default normalizePersist;

package/dist/features/views/normalizeViews.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 { type } from '@lowdefy/helpers';
+import getViewKey from './getViewKey.js';
+// Saved views `[{ id, title, view, shared, locked, count }]` from any source. Views often come
+// from a request, so a list that has not loaded yet (null) is an empty list. `key` is the id as a
+// string (getViewKey), for tabs and lookups; events carry the id as the app gave it.
+function normalizeViews(views) {
+    if (!type.isArray(views)) return [];
+    const seen = new Set();
+    const normalized = [];
+    views.forEach((entry)=>{
+        if (!type.isObject(entry) || type.isNone(entry.id)) return;
+        const key = getViewKey(entry.id);
+        if (seen.has(key)) return;
+        seen.add(key);
+        normalized.push({
+            id: entry.id,
+            key,
+            title: type.isNone(entry.title) ? key : String(entry.title),
+            view: type.isObject(entry.view) ? entry.view : {},
+            shared: entry.shared === true,
+            locked: entry.locked === true,
+            count: type.isNumber(entry.count) ? entry.count : undefined
+        });
+    });
+    return normalized;
+}
+export default normalizeViews;

package/dist/features/views/notifyViewSelect.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';
+// onViewSelect fires once the selected view has loaded and committed, after onChange, so its
+// actions read the new view from state.
+function notifyViewSelect({ cause, api }) {
+    if (cause !== 'view' || type.isNone(api.pendingViewSelect)) return;
+    const id = api.pendingViewSelect;
+    api.pendingViewSelect = null;
+    api.methods.triggerEvent({
+        name: 'onViewSelect',
+        event: {
+            id
+        }
+    });
+}
+export default notifyViewSelect;

package/dist/features/views/readMountPayload.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 readPersistedView from './readPersistedView.js';
+import sanitizePersistedView from './sanitizePersistedView.js';
+// The persisted payload with its view cleaned against the declared columns.
+function readMountPayload({ config }) {
+    const payload = readPersistedView({
+        persist: config.persist
+    });
+    if (payload === null) return null;
+    return {
+        view: sanitizePersistedView({
+            view: payload.view,
+            columnKeys: config.columns.map((column)=>column.key)
+        }),
+        activeView: payload.activeView
+    };
+}
+export default readMountPayload;