@multiplatform.one/frappe-ui 7.11.0 → 7.15.0

package/dist/cjs/FrappeList.native.js

@@ -45,10 +45,18 @@ function FrappeList(param) {
     doctype,
     fields,
     filters,
+    limit,
+    orderBy,
+    initialRows,
     pageSize,
     renderItem,
+    layout = "list",
+    gridProps,
+    emptyState,
+    onRetry,
     ...listProps
   } = param;
+  var _listProps_emptyMessage;
   var config = (0, import_FrappeProvider.useFrappeConfig)();
   var {
     knobProps
@@ -83,12 +91,25 @@ function FrappeList(param) {
   } = (0, import_useFrappePagination.useFrappePagination)(connectionConfig, doctype, {
     fields,
     filters,
-    pageSize
+    pageSize,
+    limit,
+    orderBy,
+    initialRows
   });
+  var itemIndex = (0, import_react.useMemo)(function () {
+    return new Map(items.map(function (item, index) {
+      return [item, index];
+    }));
+  }, [items]);
+  var renderCard = (0, import_react.useCallback)(function (item) {
+    var _itemIndex_get;
+    return renderItem(item, (_itemIndex_get = itemIndex.get(item)) !== null && _itemIndex_get !== void 0 ? _itemIndex_get : 0);
+  }, [renderItem, itemIndex]);
   if (error) {
     return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.AsyncBoundary, {
-      layout: "list",
+      layout: layout === "grid" ? "generic" : "list",
       error,
+      onRetry,
       errorTitle: (0, import_liveErrors.isPermissionError)(error) ? t("You do not have permission to view {{doctype}}", {
         doctype
       }) : t("Error loading {{doctype}}", {
@@ -98,7 +119,7 @@ function FrappeList(param) {
   }
   return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
     ...knobProps.gap,
-    flex: 1,
+    flex: layout === "grid" ? void 0 : 1,
     children: [/* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeReconnectIndicator.FrappeReconnectIndicator, {
       config: connectionConfig
     }),
@@ -109,8 +130,19 @@ function FrappeList(param) {
       clip. Rows and the error/empty panels own their own chrome; the error
       branch above renders a bare AsyncBoundary, so both paths now match.
     */
-    /* @__PURE__ */
-    (0, import_jsx_runtime.jsx)(import_components.List, {
+    !isLoading && items.length === 0 && emptyState ? emptyState : layout === "grid" ? /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.ImageGrid, {
+      items,
+      isLoading,
+      renderItem: renderCard,
+      onItemClick: listProps.onItemClick,
+      onLoadMore,
+      hasMore,
+      emptyMessage: (_listProps_emptyMessage = listProps.emptyMessage) !== null && _listProps_emptyMessage !== void 0 ? _listProps_emptyMessage : t("No {{doctype}} records found", {
+        doctype
+      }),
+      testID: listProps.testID,
+      ...gridProps
+    }) : /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.List, {
       items,
       isLoading,
       renderItem,

package/dist/cjs/FrappeList.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","FrappeList_exports","__export","FrappeList","module","exports","import_jsx_runtime","require","import_components","import_theme","import_react","import_react_i18next","import_tamagui","import_FrappeProvider","import_FrappeReconnectIndicator","import_liveErrors","import_useFrappePagination","param","baseURL","auth","syncOptions","doctype","fields","filters","pageSize","renderItem","listProps","config","useFrappeConfig","knobProps","useResolvedKnobs","t","useTranslation","finalBaseURL","finalAuth","finalSyncOptions","fixtures","Error","connectionConfig","useMemo","socketPort","siteName","socketBaseURL","realtime","items","isLoading","onLoadMore","hasMore","error","useFrappePagination","jsx","AsyncBoundary","layout","errorTitle","isPermissionError","jsxs","YStack","gap","flex","children","FrappeReconnectIndicator","List","emptyMessage"],"sources":["../../src/FrappeList.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["__toCommonJS","mod","__copyProps","__defProp","value","FrappeList_exports","__export","FrappeList","module","exports","import_jsx_runtime","require","import_components","import_theme","import_react","import_react_i18next","import_tamagui","import_FrappeProvider","import_FrappeReconnectIndicator","import_liveErrors","import_useFrappePagination","param","baseURL","auth","syncOptions","doctype","fields","filters","limit","orderBy","initialRows","pageSize","renderItem","layout","gridProps","emptyState","onRetry","listProps","_listProps_emptyMessage","config","useFrappeConfig","knobProps","useResolvedKnobs","t","useTranslation","finalBaseURL","finalAuth","finalSyncOptions","fixtures","Error","connectionConfig","useMemo","socketPort","siteName","socketBaseURL","realtime","items","isLoading","onLoadMore","hasMore","error","useFrappePagination","itemIndex","Map","map","item","index","renderCard","useCallback","_itemIndex_get","get","jsx","AsyncBoundary","errorTitle","isPermissionError","jsxs","YStack","gap","flex","children","FrappeReconnectIndicator","length","ImageGrid","onItemClick","emptyMessage","testID","List"],"sources":["../../src/FrappeList.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/cjs/FrappeListView.cjs

@@ -49,6 +49,10 @@ var import_store = require("@multiplatform.one/store");
 var import_FrappeProvider = require("./FrappeProvider.cjs");
 var import_FrappeList = require("./FrappeList.cjs");
 var import_FrappeTable = require("./FrappeTable.cjs");
+var import_frappeNavigation = require("./frappeNavigation.cjs");
+var import_frappeConnections = require("./frappeConnections.cjs");
+var import_liveErrors = require("./liveErrors.cjs");
+var import_useConnectionFilters = require("./useConnectionFilters.cjs");
 var import_jsx_runtime = require("react/jsx-runtime");
 const storageKeyPrefix = "frappe-listview-";
 const internalDocKeys = /* @__PURE__ */new Set(["name", "owner", "creation", "modified", "modified_by", "docstatus", "idx", "doctype", "_user_tags", "_comments", "_assign", "_liked_by", "_seen"]);
@@ -65,7 +69,7 @@ function resolveImageUrl(value, baseURL) {
 async function getStoredViewMode(doctype) {
   try {
     const stored = await Promise.resolve(import_store.storage.getItem(`${storageKeyPrefix}${doctype}`));
-    if (stored === "list" || stored === "table") return stored;
+    if (stored === "list" || stored === "table" || stored === "grid") return stored;
   } catch {}
   return null;
 }
@@ -77,12 +81,26 @@ async function setStoredViewMode(doctype, mode) {
 function FrappeListView({
   doctype,
   fields,
+  connections,
   filters,
   defaultViewMode = "list",
-  onItemClick,
-  onAdd,
+  viewMode: controlledViewMode,
+  onViewModeChange,
+  onItemClick: onItemClickProp,
+  onAdd: onAddProp,
+  route,
+  orderBy,
+  limit,
+  initialRows,
   columns,
   displayFields,
+  renderCard,
+  gridProps,
+  emptyState,
+  onRetry,
+  pageSize,
+  showSearch = true,
+  surface = true,
   showToolbar = true,
   showFilterSidebar = false,
   // deprecated: switcher always renders; destructured so it stays out of stackProps
@@ -93,6 +111,7 @@ function FrappeListView({
   ...stackProps
 }) {
   const config = (0, import_FrappeProvider.useFrappeConfig)();
+  const navigate = (0, import_frappeNavigation.useFrappeRouter)()?.navigate;
   const {
     knobProps
   } = (0, import_theme.useResolvedKnobs)();
@@ -116,7 +135,9 @@ function FrappeListView({
     realtime: config?.realtime,
     fixtures: config?.fixtures
   };
-  const [viewMode, setViewModeState] = (0, import_react2.useState)(defaultViewMode);
+  const [storedViewMode, setViewModeState] = (0, import_react2.useState)(defaultViewMode);
+  const requestedViewMode = controlledViewMode ?? storedViewMode;
+  const viewMode = requestedViewMode === "grid" && !renderCard ? "list" : requestedViewMode;
   (0, import_react2.useEffect)(() => {
     let cancelled = false;
     setViewModeState(defaultViewMode);
@@ -131,14 +152,33 @@ function FrappeListView({
     };
   }, [doctype, defaultViewMode]);
   const setViewMode = (0, import_react2.useCallback)(mode => {
+    onViewModeChange?.(mode);
+    if (controlledViewMode !== void 0) return;
     setViewModeState(mode);
     void setStoredViewMode(doctype, mode);
-  }, [doctype]);
+  }, [doctype, controlledViewMode, onViewModeChange]);
   const {
     meta,
     isLoading: isMetaLoading,
     error: metaError
   } = (0, import_frappe.useDocTypeMeta)(connectionConfig, doctype);
+  const onItemClick = onItemClickProp ?? (route !== void 0 && navigate ? doc => {
+    if (doc.name) navigate((0, import_frappeNavigation.frappeRouteHref)(route, {
+      mode: "view",
+      name: doc.name
+    }));
+  } : void 0);
+  const onAdd = onAddProp ?? (route !== void 0 && navigate && meta ? () => navigate((0, import_frappeNavigation.frappeRouteHref)(route, {
+    mode: "create"
+  })) : void 0);
+  const asPage = view => route === void 0 ? view : /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.ListPageLayout, {
+    scroll: false,
+    header: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.PageHeader, {
+      title: doctype,
+      divider: false
+    }),
+    children: view
+  });
   const [peekedFields, setPeekedFields] = (0, import_react2.useState)(null);
   (0, import_react2.useEffect)(() => {
     if (meta || isMetaLoading || !metaError || !finalBaseURL) return;
@@ -275,6 +315,9 @@ function FrappeListView({
   (0, import_react2.useEffect)(() => {
     setActiveFilters(filters);
   }, [filters]);
+  const effectiveConnections = (0, import_react2.useMemo)(() => connections ?? (isMetaLoading ? void 0 : (0, import_frappeConnections.connectionsFromMeta)(meta)), [connections, isMetaLoading, meta]);
+  const linkFilters = (0, import_useConnectionFilters.useConnectionFilters)(connectionConfig, doctype, activeFilters, effectiveConnections);
+  const resolvedFilters = linkFilters.filters;
   const [searchText, setSearchText] = (0, import_react2.useState)("");
   const [debouncedSearch, setDebouncedSearch] = (0, import_react2.useState)("");
   const searchField = (0, import_react2.useMemo)(() => {
@@ -285,12 +328,12 @@ function FrappeListView({
   }, [meta, metaListFields, peekedFields]);
   const listFilters = (0, import_react2.useMemo)(() => {
     const query = debouncedSearch.trim();
-    if (!query) return activeFilters;
+    if (!query) return resolvedFilters;
     const searchFilter = [searchField, "like", `%${query}%`];
-    if (!activeFilters) return [searchFilter];
-    if (Array.isArray(activeFilters)) return [...activeFilters, searchFilter];
-    return [...Object.entries(activeFilters).map(([key, value]) => [key, "=", value]), searchFilter];
-  }, [activeFilters, debouncedSearch, searchField]);
+    if (!resolvedFilters) return [searchFilter];
+    if (Array.isArray(resolvedFilters)) return [...resolvedFilters, searchFilter];
+    return [...Object.entries(resolvedFilters).map(([key, value]) => [key, "=", value]), searchFilter];
+  }, [resolvedFilters, debouncedSearch, searchField]);
   const hasProvidedFilters = (0, import_react2.useMemo)(() => {
     if (!activeFilters) return false;
     return Array.isArray(activeFilters) ? activeFilters.length > 0 : Object.keys(activeFilters).length > 0;
@@ -316,8 +359,8 @@ function FrappeListView({
   const handleDeleteFilter = (0, import_react2.useCallback)(async name => {
     await savedFiltersHook.deleteFilter(name);
   }, [savedFiltersHook]);
-  if (isMetaLoading) {
-    return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
+  if (isMetaLoading && !fields) {
+    return asPage(/* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
       ...knobProps.panelPadding,
       alignItems: "center",
       justifyContent: "center",
@@ -332,7 +375,7 @@ function FrappeListView({
           doctype
         })
       })]
-    });
+    }));
   }
   const renderToolbar = () => {
     if (!showToolbar) return null;
@@ -347,7 +390,10 @@ function FrappeListView({
         alignItems: "center",
         ...knobProps.gap,
         children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.ViewSwitcher, {
-          views: [{
+          views: [...(renderCard ? [{
+            type: "grid",
+            label: t("Cards")
+          }] : []), {
             type: "list",
             label: t("List")
           }, {
@@ -452,28 +498,37 @@ function FrappeListView({
     })
   });
   const renderContent = () => {
-    if (viewMode === "list") {
+    if (viewMode === "list" || viewMode === "grid") {
+      const isGrid = viewMode === "grid";
       return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
-        flex: 1,
-        children: [renderListSearch(), /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeList.FrappeList, {
+        flex: isGrid ? void 0 : 1,
+        children: [showSearch ? renderListSearch() : null, /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeList.FrappeList, {
+          layout: isGrid ? "grid" : "list",
+          gridProps,
+          emptyState,
+          pageSize,
+          onRetry: onRetry ?? handleRefresh,
           doctype,
           fields: effectiveFields,
           filters: listFilters,
-          renderItem: renderListItem,
+          renderItem: isGrid && renderCard ? renderCard : renderListItem,
           onItemClick,
           baseURL: finalBaseURL,
           auth: finalAuth,
           syncOptions: finalSyncOptions,
+          orderBy,
+          limit,
+          initialRows,
           ...(noResultsMessage ? {
             emptyMessage: noResultsMessage
           } : {})
-        }, `list-${refreshKey}`)]
+        }, `${viewMode}-${refreshKey}`)]
       });
     }
     return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeTable.FrappeTable, {
       doctype,
       fields: effectiveFields,
-      filters: activeFilters,
+      filters: resolvedFilters,
       columns: effectiveColumns,
       onRowClick: onItemClick,
       baseURL: finalBaseURL,
@@ -481,19 +536,37 @@ function FrappeListView({
       syncOptions: finalSyncOptions
     }, `table-${refreshKey}`);
   };
-  return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
-    flex: 1,
-    ...knobProps.surface,
-    ...knobProps.containerRadius,
-    overflow: "hidden",
+  const renderResolvedContent = () => {
+    if (linkFilters.error) {
+      return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.AsyncBoundary, {
+        layout: "list",
+        error: linkFilters.error,
+        errorTitle: (0, import_liveErrors.isPermissionError)(linkFilters.error) ? t("You do not have permission to view {{doctype}}", {
+          doctype
+        }) : t("Error loading {{doctype}}", {
+          doctype
+        })
+      });
+    }
+    if (linkFilters.pending) return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.AsyncBoundary, {
+      layout: "list",
+      loading: true
+    });
+    return renderContent();
+  };
+  return asPage(/* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
+    flex: viewMode === "grid" ? void 0 : 1,
+    ...(surface ? knobProps.surface : {}),
+    ...(surface ? knobProps.containerRadius : {}),
+    overflow: surface ? "hidden" : void 0,
     testID: `${doctype.toLowerCase()}-list`,
     ...stackProps,
-    children: [renderToolbar(), showFilterSidebar ? /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.XStack, {
+    children: [renderToolbar(), linkFilters.readers, showFilterSidebar ? /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.XStack, {
       flex: 1,
       children: [renderFilterSidebar(), /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_tamagui.YStack, {
         flex: 1,
-        children: renderContent()
+        children: renderResolvedContent()
       })]
-    }) : renderContent()]
-  });
+    }) : renderResolvedContent()]
+  }));
 }

package/dist/cjs/FrappeListView.native.js

@@ -52,6 +52,10 @@ var import_store = require("@multiplatform.one/store");
 var import_FrappeProvider = require("./FrappeProvider.native.js");
 var import_FrappeList = require("./FrappeList.native.js");
 var import_FrappeTable = require("./FrappeTable.native.js");
+var import_frappeNavigation = require("./frappeNavigation.native.js");
+var import_frappeConnections = require("./frappeConnections.native.js");
+var import_liveErrors = require("./liveErrors.native.js");
+var import_useConnectionFilters = require("./useConnectionFilters.native.js");
 var storageKeyPrefix = "frappe-listview-";
 var internalDocKeys = /* @__PURE__ */new Set(["name", "owner", "creation", "modified", "modified_by", "docstatus", "idx", "doctype", "_user_tags", "_comments", "_assign", "_liked_by", "_seen"]);
 var layoutFieldtypes = /* @__PURE__ */new Set(["Column Break", "Section Break", "Tab Break", "HTML", "Heading", "Fold", "Button"]);
@@ -69,7 +73,7 @@ function resolveImageUrl(value, baseURL) {
 async function getStoredViewMode(doctype) {
   try {
     var stored = await Promise.resolve(import_store.storage.getItem(`${storageKeyPrefix}${doctype}`));
-    if (stored === "list" || stored === "table") return stored;
+    if (stored === "list" || stored === "table" || stored === "grid") return stored;
   } catch (unused) {}
   return null;
 }
@@ -82,12 +86,26 @@ function FrappeListView(param) {
   var {
     doctype,
     fields,
+    connections,
     filters,
     defaultViewMode = "list",
-    onItemClick,
-    onAdd,
+    viewMode: controlledViewMode,
+    onViewModeChange,
+    onItemClick: onItemClickProp,
+    onAdd: onAddProp,
+    route,
+    orderBy,
+    limit,
+    initialRows,
     columns,
     displayFields,
+    renderCard,
+    gridProps,
+    emptyState,
+    onRetry,
+    pageSize,
+    showSearch = true,
+    surface = true,
     showToolbar = true,
     showFilterSidebar = false,
     // deprecated: switcher always renders; destructured so it stays out of stackProps
@@ -97,7 +115,9 @@ function FrappeListView(param) {
     syncOptions,
     ...stackProps
   } = param;
+  var _useFrappeRouter;
   var config = (0, import_FrappeProvider.useFrappeConfig)();
+  var navigate = (_useFrappeRouter = (0, import_frappeNavigation.useFrappeRouter)()) === null || _useFrappeRouter === void 0 ? void 0 : _useFrappeRouter.navigate;
   var {
     knobProps
   } = (0, import_theme.useResolvedKnobs)();
@@ -121,7 +141,9 @@ function FrappeListView(param) {
     realtime: config === null || config === void 0 ? void 0 : config.realtime,
     fixtures: config === null || config === void 0 ? void 0 : config.fixtures
   };
-  var [viewMode, setViewModeState] = (0, import_react2.useState)(defaultViewMode);
+  var [storedViewMode, setViewModeState] = (0, import_react2.useState)(defaultViewMode);
+  var requestedViewMode = controlledViewMode !== null && controlledViewMode !== void 0 ? controlledViewMode : storedViewMode;
+  var viewMode = requestedViewMode === "grid" && !renderCard ? "list" : requestedViewMode;
   (0, import_react2.useEffect)(function () {
     var cancelled = false;
     setViewModeState(defaultViewMode);
@@ -136,14 +158,37 @@ function FrappeListView(param) {
     };
   }, [doctype, defaultViewMode]);
   var setViewMode = (0, import_react2.useCallback)(function (mode) {
+    onViewModeChange === null || onViewModeChange === void 0 ? void 0 : onViewModeChange(mode);
+    if (controlledViewMode !== void 0) return;
     setViewModeState(mode);
     void setStoredViewMode(doctype, mode);
-  }, [doctype]);
+  }, [doctype, controlledViewMode, onViewModeChange]);
   var {
     meta,
     isLoading: isMetaLoading,
     error: metaError
   } = (0, import_frappe.useDocTypeMeta)(connectionConfig, doctype);
+  var onItemClick = onItemClickProp !== null && onItemClickProp !== void 0 ? onItemClickProp : route !== void 0 && navigate ? function (doc) {
+    if (doc.name) navigate((0, import_frappeNavigation.frappeRouteHref)(route, {
+      mode: "view",
+      name: doc.name
+    }));
+  } : void 0;
+  var onAdd = onAddProp !== null && onAddProp !== void 0 ? onAddProp : route !== void 0 && navigate && meta ? function () {
+    return navigate((0, import_frappeNavigation.frappeRouteHref)(route, {
+      mode: "create"
+    }));
+  } : void 0;
+  var asPage = function asPage2(view) {
+    return route === void 0 ? view : /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.ListPageLayout, {
+      scroll: false,
+      header: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.PageHeader, {
+        title: doctype,
+        divider: false
+      }),
+      children: view
+    });
+  };
   var [peekedFields, setPeekedFields] = (0, import_react2.useState)(null);
   (0, import_react2.useEffect)(function () {
     if (meta || isMetaLoading || !metaError || !finalBaseURL) return;
@@ -316,6 +361,11 @@ function FrappeListView(param) {
   (0, import_react2.useEffect)(function () {
     setActiveFilters(filters);
   }, [filters]);
+  var effectiveConnections = (0, import_react2.useMemo)(function () {
+    return connections !== null && connections !== void 0 ? connections : isMetaLoading ? void 0 : (0, import_frappeConnections.connectionsFromMeta)(meta);
+  }, [connections, isMetaLoading, meta]);
+  var linkFilters = (0, import_useConnectionFilters.useConnectionFilters)(connectionConfig, doctype, activeFilters, effectiveConnections);
+  var resolvedFilters = linkFilters.filters;
   var [searchText, setSearchText] = (0, import_react2.useState)("");
   var [debouncedSearch, setDebouncedSearch] = (0, import_react2.useState)("");
   var searchField = (0, import_react2.useMemo)(function () {
@@ -326,15 +376,15 @@ function FrappeListView(param) {
   }, [meta, metaListFields, peekedFields]);
   var listFilters = (0, import_react2.useMemo)(function () {
     var query = debouncedSearch.trim();
-    if (!query) return activeFilters;
+    if (!query) return resolvedFilters;
     var searchFilter = [searchField, "like", `%${query}%`];
-    if (!activeFilters) return [searchFilter];
-    if (Array.isArray(activeFilters)) return [...activeFilters, searchFilter];
-    return [...Object.entries(activeFilters).map(function (param2) {
+    if (!resolvedFilters) return [searchFilter];
+    if (Array.isArray(resolvedFilters)) return [...resolvedFilters, searchFilter];
+    return [...Object.entries(resolvedFilters).map(function (param2) {
       var [key, value] = param2;
       return [key, "=", value];
     }), searchFilter];
-  }, [activeFilters, debouncedSearch, searchField]);
+  }, [resolvedFilters, debouncedSearch, searchField]);
   var hasProvidedFilters = (0, import_react2.useMemo)(function () {
     if (!activeFilters) return false;
     return Array.isArray(activeFilters) ? activeFilters.length > 0 : Object.keys(activeFilters).length > 0;
@@ -362,8 +412,8 @@ function FrappeListView(param) {
   var handleDeleteFilter = (0, import_react2.useCallback)(async function (name) {
     await savedFiltersHook.deleteFilter(name);
   }, [savedFiltersHook]);
-  if (isMetaLoading) {
-    return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
+  if (isMetaLoading && !fields) {
+    return asPage(/* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
       ...knobProps.panelPadding,
       alignItems: "center",
       justifyContent: "center",
@@ -378,7 +428,7 @@ function FrappeListView(param) {
           doctype
         })
       })]
-    });
+    }));
   }
   var renderToolbar = function renderToolbar2() {
     if (!showToolbar) return null;
@@ -395,7 +445,10 @@ function FrappeListView(param) {
         alignItems: "center",
         ...knobProps.gap,
         children: /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.ViewSwitcher, {
-          views: [{
+          views: [...(renderCard ? [{
+            type: "grid",
+            label: t("Cards")
+          }] : []), {
             type: "list",
             label: t("List")
           }, {
@@ -518,30 +571,39 @@ function FrappeListView(param) {
     });
   };
   var renderContent = function renderContent2() {
-    if (viewMode === "list") {
+    if (viewMode === "list" || viewMode === "grid") {
+      var isGrid = viewMode === "grid";
       return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
-        flex: 1,
-        children: [renderListSearch(), /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeList.FrappeList, {
+        flex: isGrid ? void 0 : 1,
+        children: [showSearch ? renderListSearch() : null, /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeList.FrappeList, {
+          layout: isGrid ? "grid" : "list",
+          gridProps,
+          emptyState,
+          pageSize,
+          onRetry: onRetry !== null && onRetry !== void 0 ? onRetry : handleRefresh,
           doctype,
           fields: effectiveFields,
           filters: listFilters,
-          renderItem: renderListItem,
+          renderItem: isGrid && renderCard ? renderCard : renderListItem,
           onItemClick,
           baseURL: finalBaseURL,
           auth: finalAuth,
           syncOptions: finalSyncOptions,
+          orderBy,
+          limit,
+          initialRows,
           // Only override when narrowing is active: FrappeList's own
           // "No {doctype} records found" stays the true-empty message.
           ...(noResultsMessage ? {
             emptyMessage: noResultsMessage
           } : {})
-        }, `list-${refreshKey}`)]
+        }, `${viewMode}-${refreshKey}`)]
       });
     }
     return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_FrappeTable.FrappeTable, {
       doctype,
       fields: effectiveFields,
-      filters: activeFilters,
+      filters: resolvedFilters,
       columns: effectiveColumns,
       onRowClick: onItemClick,
       baseURL: finalBaseURL,
@@ -549,20 +611,38 @@ function FrappeListView(param) {
       syncOptions: finalSyncOptions
     }, `table-${refreshKey}`);
   };
-  return /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
-    flex: 1,
-    ...knobProps.surface,
-    ...knobProps.containerRadius,
-    overflow: "hidden",
+  var renderResolvedContent = function renderResolvedContent2() {
+    if (linkFilters.error) {
+      return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.AsyncBoundary, {
+        layout: "list",
+        error: linkFilters.error,
+        errorTitle: (0, import_liveErrors.isPermissionError)(linkFilters.error) ? t("You do not have permission to view {{doctype}}", {
+          doctype
+        }) : t("Error loading {{doctype}}", {
+          doctype
+        })
+      });
+    }
+    if (linkFilters.pending) return /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_components.AsyncBoundary, {
+      layout: "list",
+      loading: true
+    });
+    return renderContent();
+  };
+  return asPage(/* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.YStack, {
+    flex: viewMode === "grid" ? void 0 : 1,
+    ...(surface ? knobProps.surface : {}),
+    ...(surface ? knobProps.containerRadius : {}),
+    overflow: surface ? "hidden" : void 0,
     testID: `${doctype.toLowerCase()}-list`,
     ...stackProps,
-    children: [renderToolbar(), showFilterSidebar ? /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.XStack, {
+    children: [renderToolbar(), linkFilters.readers, showFilterSidebar ? /* @__PURE__ */(0, import_jsx_runtime.jsxs)(import_tamagui.XStack, {
       flex: 1,
       children: [renderFilterSidebar(), /* @__PURE__ */(0, import_jsx_runtime.jsx)(import_tamagui.YStack, {
         flex: 1,
-        children: renderContent()
+        children: renderResolvedContent()
       })]
-    }) : renderContent()]
-  });
+    }) : renderResolvedContent()]
+  }));
 }
 //# sourceMappingURL=FrappeListView.native.js.map