blixify-ui-web-mcp 0.1.42 → 0.1.43

package/lib/components/data/dataTemplate/README.md

@@ -1095,7 +1095,6 @@ Which field types can be edited from the list table, and how. Types not listed u
 | `groupIdCollapsible`          | `{ [key: string]: boolean }`                                                | Initial collapsed/expanded state per group ID                                                                                                                                                                                                                                                                         |
 | `sortGroupByAlphabetically`   | `boolean`                                                                   | Sorts group-by values alphabetically                                                                                                                                                                                                                                                                                  |
 | `unionCollections`            | `any[]`                                                                     | Additional collections to union-query alongside the main collection                                                                                                                                                                                                                                                   |
-| `unionPagination`             | `boolean`                                                                   | Opt in to paging a union list: sends the page offset as `skip` and adds `_id` to the sort as a tie-break (default `false`). See *Union Collections* in the DataWrapper README                                                                                                                                         |
 | `moreSettings`                | `{ text: string; onClick: () => void }[]`                                   | Extra items appended to the "more" dropdown menu                                                                                                                                                                                                                                                                      |
 | `exportSettings`              | `ExportSettings`                                                            | See Export Settings below                                                                                                                                                                                                                                                                                             |
 | `onChangeSort`                | `(value: Sort) => void`                                                     | Called when the user changes the sort                                                                                                                                                                                                                                                                                 |

package/lib/components/data/dataWrapper/README.md

@@ -1017,28 +1017,23 @@ organise={{
 
 ---
 
-### Paging a union list — `unionPagination`
+### Paging a union list
 
-A union list does not page on its own. The DTW sends `skip: 0` for every union request, so page 2 (or the next scroll load) returns the first rows again. If the app fetches the whole union in one request and pages it itself, that is fine and nothing changes.
+A union list pages on the server like any other list. Each page request:
 
-Set `organise.unionPagination` to let the server do the paging instead. It is **off by default**, so upgrading the library changes nothing until you opt in.
+- sends `skip = pageIndex × limit` (the first page is `0`);
+- sends the sort followed by `_id` in the same direction, e.g. `[{ sortId: "sortDate", type: "asc" }, { sortId: "_id", type: "asc" }]`. Every page is a separate request, and two rows with the same sort value have no fixed order between requests, so without the tie-break a row can appear on two pages or on none. With no sort set, the server default (`date` descending) is kept and `_id` is added after it.
 
 ```tsx
 organise={{
   unionCollections: [/* ... */],
-  unionPagination: true,
   paginationType: "scroll", // or "page"
   sort: { sortId: "sortDate", type: "asc" },
 }}
 limit={20}
 ```
 
-With it on, each page request:
-
-- sends `skip = pageIndex × limit` (the first page is `0`);
-- sends the sort followed by `_id` in the same direction, e.g. `[{ sortId: "sortDate", type: "asc" }, { sortId: "_id", type: "asc" }]`. Every page is a separate request, and two rows with the same sort value have no fixed order between requests, so without the tie-break a row can appear on two pages or on none. With no sort set, the server default (`date` descending) is kept and `_id` is added after it.
-
-It only applies with `unionCollections`. Calendar, map and timeline views fetch the full set and are not affected.
+Calendar, map, timeline and `groupId` views fetch the full set and are not paged.
 
 ---
 

package/lib/components/data/dataWrapper/dataWrapper.scrollFilters.stories.tsx

@@ -0,0 +1,122 @@
+import axios from "axios";
+import MockAdapter from "axios-mock-adapter";
+import React, { useEffect, useMemo, useState } from "react";
+import { DataTemplateWrapper } from ".";
+import {
+  DEFAULT_VIEWS,
+  DEMO_ENDPOINT,
+  DEMO_SCHEMA,
+  demoDevSettings,
+  renderDemoRecords,
+} from "../dataTemplate/savedViewsDemo.fixtures";
+
+const meta = { title: "Data/Data Wrapper/Scroll Filters" };
+export default meta;
+
+const COLLECTION = "demo-scroll-filter-tasks";
+
+// INFO: an unfiltered read answers slower than a filtered one, so applying a
+// view while the first load is in flight makes the old answer land last —
+// the order that put rows from an earlier filter on screen
+const UNFILTERED_DELAY = 1500;
+const FILTERED_DELAY = 100;
+
+const workspace = {
+  apiEndpointType: "mongoDB" as const,
+  apiEndpoint: DEMO_ENDPOINT,
+  apiEndpointToken: "",
+  apiUserToken: "",
+  assetEndpoint: "",
+  assetUploadEndpoint: "",
+};
+
+const handleInstallScrollMock = (store: any[]) => {
+  const mock = new MockAdapter(axios, { onNoMatch: "passthrough" });
+  mock.onPost(`${DEMO_ENDPOINT}/${COLLECTION}/list`).reply((config) => {
+    let body: any = {};
+    try {
+      body = JSON.parse(config?.data ?? "{}");
+    } catch (err) {
+      body = {};
+    }
+    const stageQuery = (body.query ?? []).find(
+      (eachQuery: any) => eachQuery?.queryId === "stage",
+    );
+    const rows = stageQuery
+      ? store.filter((each) => each.stage === stageQuery.value)
+      : store;
+    const cursor = typeof body.cursor === "number" ? body.cursor : 0;
+    const limit = typeof body.limit === "number" ? body.limit : rows.length;
+    return new Promise((resolve) =>
+      setTimeout(
+        () =>
+          resolve([
+            200,
+            { data: rows.slice(cursor, cursor + limit), count: rows.length },
+          ]),
+        stageQuery ? FILTERED_DELAY : UNFILTERED_DELAY,
+      ),
+    );
+  });
+  mock
+    .onPost(`${DEMO_ENDPOINT}/spaces/list`)
+    .reply(200, { data: [], count: 0 });
+  return mock;
+};
+
+const ScrollFiltersDemo = () => {
+  const [isMockReady, setIsMockReady] = useState(false);
+  const store = useMemo(() => renderDemoRecords(), []);
+
+  // INFO: in an effect so it survives StrictMode's double mount
+  useEffect(() => {
+    const mock = handleInstallScrollMock(store);
+    setIsMockReady(true);
+    return () => {
+      mock.restore();
+      setIsMockReady(false);
+    };
+  }, [store]);
+
+  if (!isMockReady) return null;
+  return (
+    <DataTemplateWrapper
+      title="Tasks"
+      description="40 offline records"
+      type="list"
+      collectionId={COLLECTION}
+      schema={DEMO_SCHEMA}
+      workspace={workspace}
+      devSettings={{
+        schemaEndpoint: demoDevSettings.schemaEndpoint,
+        currentUser: demoDevSettings.currentUser,
+      }}
+      limit={10}
+      organise={{
+        breadcrumbType: "hidden",
+        paginationType: "scroll",
+        savedViews: true,
+        defaultSavedViews: DEFAULT_VIEWS,
+      }}
+      bareSettings={{
+        bareNewDTW: true,
+        bareFlexFilters: true,
+      }}
+    />
+  );
+};
+
+export const ScrollFilters = () => (
+  <div className="w-full">
+    <div className="font-semibold mb-1 text-gray-900">
+      DataTemplateWrapper — scroll list with flex filters
+    </div>
+    <div className="text-sm mb-4 text-gray-600">
+      A scroll-paginated list where an unfiltered read answers slower than a
+      filtered one. Apply “In progress” during the first load, or clear the
+      filter afterwards: the table must show only the rows of the current
+      filter, and the result count must match the rows on screen.
+    </div>
+    <ScrollFiltersDemo />
+  </div>
+);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blixify-ui-web-mcp",
-  "version": "0.1.42",
+  "version": "0.1.43",
   "license": "MIT",
   "main": "lib/mcp/server.js",
   "bin": {