ding-react-admin 2.1.0 → 2.2.1

package/dist/src/components/AppHub.d.ts

@@ -1,8 +1,17 @@
+import { FlatNavItem } from '../layouts/navFilter';
 import { NavItem } from '../types';
 export type AppHubProps = {
     apps: NavItem[];
+    /** Flattened leaf menus from all apps — enables cross-app search when set. */
+    menuItems?: FlatNavItem[];
     onAppClick?: (app: NavItem) => void;
+    onMenuClick?: (item: FlatNavItem) => void;
+    menuSearchPlaceholder?: string;
     className?: string;
+    /** Max width of the centered hub content. Default `960`. */
+    maxWidth?: number;
+    /** When true, shows a centered spinner instead of the app grid. */
+    loading?: boolean;
 };
-export declare function AppHub({ apps, onAppClick, className }: AppHubProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppHub({ apps, menuItems, onAppClick, onMenuClick, menuSearchPlaceholder, className, maxWidth, loading, }: AppHubProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AppHub.d.ts.map

package/dist/src/components/AppHub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppHub.d.ts","sourceRoot":"","sources":["../../../src/components/AppHub.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,WAAW,2CAoClE"}
+{"version":3,"file":"AppHub.d.ts","sourceRoot":"","sources":["../../../src/components/AppHub.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IAC1C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,SAAS,EACT,UAAU,EACV,WAAW,EACX,qBAAmD,EACnD,SAAS,EACT,QAAc,EACd,OAAe,GAChB,EAAE,WAAW,2CA+Gb"}

package/dist/src/index.d.ts

@@ -17,6 +17,8 @@ export { applyInMemoryListParams, filterRows, getById as getRowById, } from './d
 export type { CombineResourceHandlersOptions, ResourceAction, ResourceGuard, ResourceHandlerEntry, ResourceHandlerMap, ResourceHandlers, } from './data/resourceHandlers';
 export type { ResourcePermissions } from './permissions/resourcePermissions';
 export { filterNavByPermission } from './permissions/resourcePermissions';
+export { flattenNavLeaves, filterFlatNavItems, filterNavItems, getNavItemLabel, } from './layouts/navFilter';
+export type { FlatNavItem } from './layouts/navFilter';
 export type { MemoryResourceHandlersConfig } from './data/createMemoryResourceHandlers';
 export type { PermissionsChecker } from './context/PermissionsProvider';
 export { LoginPage } from './pages/LoginPage';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/layouts/navFilter.d.ts

@@ -1,5 +1,17 @@
+import { ReactNode } from 'react';
 import { NavItem } from '../types';
-export declare function getNavItemLabel(item: NavItem): string;
+export type FlatNavItem = {
+    path: string;
+    label: ReactNode;
+    group?: string;
+    Icon?: NavItem["Icon"];
+};
+export declare function getNavItemLabel(item: Pick<NavItem, "label">): string;
 export declare function filterNavItems(items: NavItem[], query: string): NavItem[];
+/** Leaf menu rows from a nav tree, optionally tagged with an app/group name. */
+export declare function flattenNavLeaves(items: NavItem[], options?: {
+    group?: string;
+}): FlatNavItem[];
+export declare function filterFlatNavItems(items: FlatNavItem[], query: string): FlatNavItem[];
 export declare function collectSubmenuKeys(items: NavItem[]): string[];
 //# sourceMappingURL=navFilter.d.ts.map

package/dist/src/layouts/navFilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navFilter.d.ts","sourceRoot":"","sources":["../../../src/layouts/navFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAKrD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAyBzE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAY7D"}
+{"version":3,"file":"navFilter.d.ts","sourceRoot":"","sources":["../../../src/layouts/navFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACxB,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,CAKpE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAyBzE;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3B,WAAW,EAAE,CAqBf;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CASf;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAY7D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ding-react-admin",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "type": "module",
   "license": "MIT",
   "description": "Composable admin shell (Ant Design + React Router): quick-start AdminApp or build your own layout.",

package/src/components/AppHub.tsx

@@ -1,17 +1,43 @@
-import { Card, Col, Row, Space, Typography } from "antd";
+import { Card, Col, List, Row, Space, Spin, Typography, theme } from "antd";
+import { useMemo, useState } from "react";
 import { useNavigate } from "react-router-dom";
+import {
+  filterFlatNavItems,
+  getNavItemLabel,
+} from "../layouts/navFilter";
+import type { FlatNavItem } from "../layouts/navFilter";
 import type { NavItem } from "../types";
+import { NavMenuSearch } from "./NavMenuSearch";
 
 export type AppHubProps = {
   apps: NavItem[];
+  /** Flattened leaf menus from all apps — enables cross-app search when set. */
+  menuItems?: FlatNavItem[];
   onAppClick?: (app: NavItem) => void;
+  onMenuClick?: (item: FlatNavItem) => void;
+  menuSearchPlaceholder?: string;
   className?: string;
+  /** Max width of the centered hub content. Default `960`. */
+  maxWidth?: number;
+  /** When true, shows a centered spinner instead of the app grid. */
+  loading?: boolean;
 };
 
-export function AppHub({ apps, onAppClick, className }: AppHubProps) {
+export function AppHub({
+  apps,
+  menuItems,
+  onAppClick,
+  onMenuClick,
+  menuSearchPlaceholder = "Search menus across apps…",
+  className,
+  maxWidth = 960,
+  loading = false,
+}: AppHubProps) {
   const navigate = useNavigate();
+  const { token } = theme.useToken();
+  const [query, setQuery] = useState("");
 
-  const handleClick = (app: NavItem) => {
+  const handleAppClick = (app: NavItem) => {
     if (onAppClick) {
       onAppClick(app);
       return;
@@ -19,29 +45,102 @@ export function AppHub({ apps, onAppClick, className }: AppHubProps) {
     navigate(app.path);
   };
 
+  const handleMenuClick = (item: FlatNavItem) => {
+    if (onMenuClick) {
+      onMenuClick(item);
+      return;
+    }
+    navigate(item.path);
+  };
+
+  const trimmedQuery = query.trim();
+  const menuResults = useMemo(
+    () =>
+      menuItems && trimmedQuery
+        ? filterFlatNavItems(menuItems, trimmedQuery)
+        : [],
+    [menuItems, trimmedQuery],
+  );
+  const isSearching = Boolean(menuItems && trimmedQuery);
+
   return (
-    <Row gutter={[16, 16]} className={className}>
-      {apps.map((app) => {
-        const Icon = app.Icon;
-        return (
-          <Col key={app.path} xs={12} sm={8} md={6} lg={4}>
-            <Card
-              hoverable
-              onClick={() => handleClick(app)}
-              styles={{ body: { textAlign: "center" } }}
-            >
-              <Space orientation="vertical" size="small">
-                {Icon ? (
-                  <span style={{ fontSize: 32, lineHeight: 1 }}>
-                    <Icon />
-                  </span>
-                ) : null}
-                <Typography.Text strong>{app.label}</Typography.Text>
-              </Space>
-            </Card>
-          </Col>
-        );
-      })}
-    </Row>
+    <div
+      className={className}
+      style={{
+        width: "100%",
+        maxWidth,
+        marginInline: "auto",
+        paddingInline: token.paddingMD,
+      }}
+    >
+      {menuItems?.length && !loading ? (
+        <div style={{ maxWidth: 480, margin: "0 auto 24px" }}>
+          <NavMenuSearch
+            value={query}
+            onChange={setQuery}
+            placeholder={menuSearchPlaceholder}
+            variant="app"
+          />
+        </div>
+      ) : null}
+
+      {loading ? (
+        <div style={{ display: "flex", justifyContent: "center", padding: token.paddingXL }}>
+          <Spin size="large" />
+        </div>
+      ) : isSearching ? (
+        <List
+          bordered
+          dataSource={menuResults}
+          locale={{ emptyText: "No menus match your search." }}
+          style={{ background: token.colorBgContainer, borderRadius: token.borderRadiusLG }}
+          renderItem={(item) => {
+            const Icon = item.Icon;
+            return (
+              <List.Item
+                style={{ cursor: "pointer" }}
+                onClick={() => handleMenuClick(item)}
+              >
+                <List.Item.Meta
+                  avatar={
+                    Icon ? (
+                      <span style={{ fontSize: 20, lineHeight: 1 }}>
+                        <Icon />
+                      </span>
+                    ) : undefined
+                  }
+                  title={getNavItemLabel(item)}
+                  description={item.group}
+                />
+              </List.Item>
+            );
+          }}
+        />
+      ) : (
+        <Row gutter={[16, 16]} justify="center">
+          {apps.map((app) => {
+            const Icon = app.Icon;
+            return (
+              <Col key={app.path} xs={12} sm={8} md={6} lg={4} style={{ maxWidth: 200 }}>
+                <Card
+                  hoverable
+                  onClick={() => handleAppClick(app)}
+                  styles={{ body: { textAlign: "center", padding: token.paddingLG } }}
+                >
+                  <Space orientation="vertical" size="middle">
+                    {Icon ? (
+                      <span style={{ fontSize: 40, lineHeight: 1 }}>
+                        <Icon />
+                      </span>
+                    ) : null}
+                    <Typography.Text strong>{app.label}</Typography.Text>
+                  </Space>
+                </Card>
+              </Col>
+            );
+          })}
+        </Row>
+      )}
+    </div>
   );
 }

package/src/index.ts

@@ -83,6 +83,13 @@ export type {
 } from "./data/resourceHandlers";
 export type { ResourcePermissions } from "./permissions/resourcePermissions";
 export { filterNavByPermission } from "./permissions/resourcePermissions";
+export {
+  flattenNavLeaves,
+  filterFlatNavItems,
+  filterNavItems,
+  getNavItemLabel,
+} from "./layouts/navFilter";
+export type { FlatNavItem } from "./layouts/navFilter";
 export type { MemoryResourceHandlersConfig } from "./data/createMemoryResourceHandlers";
 export type { PermissionsChecker } from "./context/PermissionsProvider";
 export { LoginPage } from "./pages/LoginPage";

package/src/layouts/navFilter.ts

@@ -1,6 +1,14 @@
+import type { ReactNode } from "react";
 import type { NavItem } from "../types";
 
-export function getNavItemLabel(item: NavItem): string {
+export type FlatNavItem = {
+  path: string;
+  label: ReactNode;
+  group?: string;
+  Icon?: NavItem["Icon"];
+};
+
+export function getNavItemLabel(item: Pick<NavItem, "label">): string {
   const { label } = item;
   if (typeof label === "string") return label;
   if (typeof label === "number") return String(label);
@@ -34,6 +42,47 @@ export function filterNavItems(items: NavItem[], query: string): NavItem[] {
   return walk(items);
 }
 
+/** Leaf menu rows from a nav tree, optionally tagged with an app/group name. */
+export function flattenNavLeaves(
+  items: NavItem[],
+  options?: { group?: string },
+): FlatNavItem[] {
+  const group = options?.group;
+  const result: FlatNavItem[] = [];
+
+  function walk(nodes: NavItem[]) {
+    for (const node of nodes) {
+      if (node.children?.length) {
+        walk(node.children);
+      } else {
+        result.push({
+          path: node.path,
+          label: node.label,
+          Icon: node.Icon,
+          group,
+        });
+      }
+    }
+  }
+
+  walk(items);
+  return result;
+}
+
+export function filterFlatNavItems(
+  items: FlatNavItem[],
+  query: string,
+): FlatNavItem[] {
+  const q = query.trim().toLowerCase();
+  if (!q) return [];
+
+  return items.filter((item) => {
+    const label = getNavItemLabel(item).toLowerCase();
+    const group = (item.group ?? "").toLowerCase();
+    return label.includes(q) || group.includes(q);
+  });
+}
+
 export function collectSubmenuKeys(items: NavItem[]): string[] {
   const keys: string[] = [];
   function walk(nodes: NavItem[]) {