@nocobase/portal-template-default 1.0.3 → 1.0.5

package/registry/nocobase-route-surfaces/use-refine-unsaved-changes.tsx

@@ -0,0 +1,106 @@
+import { useTranslate, useWarnAboutChange } from "@refinedev/core";
+import { TriangleAlert } from "lucide-react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogMedia,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
+
+type PendingConfirmation = {
+  promise: Promise<boolean>;
+  resolve: (allowed: boolean) => void;
+};
+
+export function useRefineUnsavedChangesGuard() {
+  const translate = useTranslate();
+  const { warnWhen, setWarnWhen } = useWarnAboutChange();
+  const [open, setOpen] = useState(false);
+  const pendingRef = useRef<PendingConfirmation | null>(null);
+
+  const settle = useCallback(
+    (allowed: boolean) => {
+      const pending = pendingRef.current;
+      if (!pending) return;
+
+      pendingRef.current = null;
+      if (allowed) setWarnWhen(false);
+      setOpen(false);
+      pending.resolve(allowed);
+    },
+    [setWarnWhen]
+  );
+
+  useEffect(
+    () => () => {
+      pendingRef.current?.resolve(false);
+      pendingRef.current = null;
+    },
+    []
+  );
+
+  const beforeClose = useCallback(() => {
+    if (!warnWhen) return true;
+    if (pendingRef.current) return pendingRef.current.promise;
+
+    let resolve!: (allowed: boolean) => void;
+    const promise = new Promise<boolean>((next) => {
+      resolve = next;
+    });
+    pendingRef.current = { promise, resolve };
+    setOpen(true);
+    return promise;
+  }, [warnWhen]);
+
+  const confirmation = useMemo(
+    () => (
+      <AlertDialog
+        open={open}
+        onOpenChange={(nextOpen) => {
+          if (!nextOpen) settle(false);
+        }}
+      >
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogMedia>
+              <TriangleAlert />
+            </AlertDialogMedia>
+            <AlertDialogTitle>
+              {translate(
+                "unsavedChanges.title",
+                "Discard unsaved changes?"
+              )}
+            </AlertDialogTitle>
+            <AlertDialogDescription>
+              {translate(
+                "unsavedChanges.description",
+                "Your changes have not been saved. Leaving now will discard them."
+              )}
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel onClick={() => settle(false)}>
+              {translate("unsavedChanges.stay", "Keep editing")}
+            </AlertDialogCancel>
+            <AlertDialogAction
+              variant="destructive"
+              onClick={() => settle(true)}
+            >
+              {translate("unsavedChanges.leave", "Discard changes")}
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    ),
+    [open, settle, translate]
+  );
+
+  return { beforeClose, confirmation };
+}

package/registry/nocobase-route-surfaces/use-route-surface-close.ts

@@ -0,0 +1,15 @@
+import { useContext } from "react";
+
+import { RouteSurfaceContext } from "./route-surface-context";
+
+export function useRouteSurfaceClose() {
+  const close = useContext(RouteSurfaceContext);
+
+  if (!close) {
+    throw new Error(
+      "useRouteSurfaceClose must be used inside a RouteDrawer, RouteDialog, or RoutePage."
+    );
+  }
+
+  return close;
+}

package/registry/nocobase-route-surfaces/use-route-surface-state.ts

@@ -0,0 +1,65 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+import { useNavigate } from "react-router";
+
+import type {
+  RouteSurfaceClose,
+  RouteSurfaceCloseOptions,
+} from "./route-surface-context";
+
+export type RouteSurfaceBeforeClose = () => boolean | Promise<boolean>;
+
+export function useRouteSurfaceState({
+  closeTo,
+  beforeClose,
+  animated,
+}: {
+  closeTo: string;
+  beforeClose?: RouteSurfaceBeforeClose;
+  animated: boolean;
+}) {
+  const navigate = useNavigate();
+  const [open, setOpen] = useState(!animated);
+  const closingRef = useRef(false);
+
+  useEffect(() => {
+    if (!animated) return;
+
+    const frame = requestAnimationFrame(() => setOpen(true));
+    return () => cancelAnimationFrame(frame);
+  }, [animated]);
+
+  const navigateAfterClose = useCallback(() => {
+    navigate(closeTo, { replace: true });
+  }, [closeTo, navigate]);
+
+  const close = useCallback<RouteSurfaceClose>(
+    async (options?: RouteSurfaceCloseOptions) => {
+      if (closingRef.current) return false;
+
+      closingRef.current = true;
+      try {
+        if (!options?.skipBeforeClose && beforeClose) {
+          const allowed = await beforeClose();
+          if (!allowed) return false;
+        }
+
+        if (animated) {
+          setOpen(false);
+        } else {
+          navigateAfterClose();
+        }
+        return true;
+      } finally {
+        closingRef.current = false;
+      }
+    },
+    [animated, beforeClose, navigateAfterClose]
+  );
+
+  return {
+    open,
+    setOpen,
+    close,
+    navigateAfterClose,
+  };
+}

package/registry.config.json

@@ -2,14 +2,41 @@
   "name": "nocobase-ai",
   "homepage": "https://www.nocobase.com",
   "items": [
+    {
+      "name": "route-surfaces",
+      "type": "registry:lib",
+      "title": "NocoBase Route Surfaces",
+      "description": "URL-backed drawer, dialog, and page containers with nested drawer stacking and a shared close lifecycle.",
+      "dependencies": [
+        "@base-ui/react@^1.6.0",
+        "@refinedev/core@^5.0.8",
+        "lucide-react@^0.487.0",
+        "react-router@^7.0.2"
+      ],
+      "registryDependencies": [
+        "alert-dialog",
+        "badge",
+        "button",
+        "card",
+        "input",
+        "label",
+        "select",
+        "textarea"
+      ],
+      "docs": "Provides presentation containers plus an integrated Demo and Prompt generator. Route definitions, ACL guards, data fetching, and business content remain application-owned.",
+      "source": {
+        "root": "registry/nocobase-route-surfaces",
+        "target": "src/extensions/nocobase-route-surfaces",
+        "include": ["."]
+      }
+    },
     {
       "name": "i18n",
       "type": "registry:block",
       "title": "NocoBase i18n",
-      "description": "Optional hybrid internationalization with frontend-owned UI resources, selected NocoBase dynamic namespaces, X-Locale synchronization, a reusable language switcher, and an integrated showcase.",
+      "description": "Optional NocoBase server-language resources, user preference persistence, reusable language controls, and an integrated showcase for the Starter's built-in i18n runtime.",
       "dependencies": [
         "@refinedev/core@^5.0.8",
-        "i18next@^25.3.2",
         "lucide-react@^0.487.0",
         "react-router@^7.0.2"
       ],
@@ -23,7 +50,7 @@
         "select",
         "textarea"
       ],
-      "docs": "Requires a compatible NocoBase Starter with the generic AppExtension i18nProvider and UserMenuItems host fields. Starter and Registry translations stay local; app:getLang is used only to merge registered dynamic namespaces such as lm-collections. The integrated Demo route documents the complete usage model.",
+      "docs": "Requires a compatible NocoBase Starter with the built-in i18n provider, shared System Settings bootstrap, and AppExtension Provider/UserMenuItems host fields. The Registry reuses systemSettings:get data and calls app:getLang only for registered dynamic namespaces such as lm-collections.",
       "source": {
         "root": "registry/nocobase-i18n",
         "target": "src/extensions/nocobase-i18n",

package/scripts/registry.mjs

@@ -2,8 +2,6 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-console.log(`Running registry script with action: ${process.argv[2]}`);
-
 const projectRoot = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
   ".."

package/src/App.tsx

@@ -5,7 +5,14 @@ import routerProvider, {
   CatchAllNavigate,
   UnsavedChangesNotifier,
 } from "@refinedev/react-router";
-import { UserCreate, UserEdit, UserList, UserShow } from "./pages/users";
+import {
+  UserCreate,
+  UserEdit,
+  UserResourceLayout,
+  RoleDetailRoute,
+  userRoutes,
+  UserShow,
+} from "./pages/users";
 import { dataProvider } from "./providers/data";
 import { Login } from "./pages/login";
 import { Register } from "./pages/register";
@@ -20,7 +27,6 @@ import { TooltipProvider } from "./components/ui/tooltip";
 import { BrandLogo } from "./components/app-shell/brand";
 import {
   AppExtensionProviders,
-  extensionI18nProvider,
   extensionResources,
   extensionRouteElements,
 } from "./app/extensions";
@@ -31,14 +37,16 @@ import { AclBootstrap } from "./components/access-control/acl-bootstrap";
 import { ResourceAccessGuard } from "./components/access-control/resource-access-guard";
 import { NavigateToAccessibleResource } from "./components/access-control/navigate-to-accessible-resource";
 import { UsersRound } from "lucide-react";
+import { i18nProvider } from "./providers/i18n";
+import { SystemSettingsProvider } from "./providers/system-settings";
 
 const coreResources: ResourceProps[] = [
   {
     name: "users",
-    list: "/users",
-    create: "/users/create",
-    edit: "/users/edit/:id",
-    show: "/users/show/:id",
+    list: userRoutes.list,
+    create: userRoutes.create,
+    edit: userRoutes.edit,
+    show: userRoutes.show,
     meta: {
       label: "Users",
       singularLabel: "User",
@@ -65,24 +73,25 @@ function App() {
     <BrowserRouter basename={basename || undefined}>
       <ThemeProvider>
         <TooltipProvider>
-          <Refine
-            dataProvider={dataProvider}
-            notificationProvider={useNotificationProvider()}
-            routerProvider={routerProvider}
-            authProvider={authProvider}
-            accessControlProvider={accessControlProvider}
-            i18nProvider={extensionI18nProvider}
-            resources={[...coreResources, ...extensionResources]}
-            options={{
-              syncWithLocation: true,
-              warnWhenUnsavedChanges: true,
-              disableTelemetry: true,
-              title: {
-                text: "NocoBase",
-                icon: <BrandLogo className="size-14 rounded-2xl" />,
-              },
-            }}
-          >
+          <SystemSettingsProvider>
+            <Refine
+              dataProvider={dataProvider}
+              notificationProvider={useNotificationProvider()}
+              routerProvider={routerProvider}
+              authProvider={authProvider}
+              accessControlProvider={accessControlProvider}
+              i18nProvider={i18nProvider}
+              resources={[...coreResources, ...extensionResources]}
+              options={{
+                syncWithLocation: true,
+                warnWhenUnsavedChanges: true,
+                disableTelemetry: true,
+                title: {
+                  text: "NocoBase",
+                  icon: <BrandLogo className="size-14 rounded-2xl" />,
+                },
+              }}
+            >
             <Routes>
               <Route
                 element={
@@ -101,15 +110,10 @@ function App() {
                 }
               >
                 <Route index element={<NavigateToAccessibleResource />} />
-                <Route path="/users">
-                  <Route
-                    index
-                    element={
-                      <ResourceAccessGuard resource="users" action="list">
-                        <UserList />
-                      </ResourceAccessGuard>
-                    }
-                  />
+                <Route
+                  path="/users"
+                  element={<UserResourceLayout />}
+                >
                   <Route
                     path="create"
                     element={
@@ -126,6 +130,14 @@ function App() {
                       </ResourceAccessGuard>
                     }
                   />
+                  <Route
+                    path="roles/:roleName"
+                    element={
+                      <ResourceAccessGuard resource="roles" action="show">
+                        <RoleDetailRoute returnTo="list" />
+                      </ResourceAccessGuard>
+                    }
+                  />
                   <Route
                     path="show/:id"
                     element={
@@ -133,7 +145,24 @@ function App() {
                         <UserShow />
                       </ResourceAccessGuard>
                     }
-                  />
+                  >
+                    <Route
+                      path="edit"
+                      element={
+                        <ResourceAccessGuard resource="users" action="edit">
+                          <UserEdit returnTo="show" />
+                        </ResourceAccessGuard>
+                      }
+                    />
+                    <Route
+                      path="roles/:roleName"
+                      element={
+                        <ResourceAccessGuard resource="roles" action="show">
+                          <RoleDetailRoute returnTo="show" />
+                        </ResourceAccessGuard>
+                      }
+                    />
+                  </Route>
                 </Route>
                 {extensionRouteElements}
                 <Route path="*" element={<ErrorComponent />} />
@@ -159,7 +188,8 @@ function App() {
             <Toaster />
             <UnsavedChangesNotifier />
             <DocumentTitleHandler appName="NocoBase" />
-          </Refine>
+            </Refine>
+          </SystemSettingsProvider>
         </TooltipProvider>
       </ThemeProvider>
     </BrowserRouter>

package/src/app/extension.ts

@@ -1,4 +1,4 @@
-import type { I18nProvider, ResourceProps } from "@refinedev/core";
+import type { ResourceProps } from "@refinedev/core";
 import type { ComponentType, PropsWithChildren, ReactElement } from "react";
 
 export type AppExtension = {
@@ -7,5 +7,4 @@ export type AppExtension = {
   routes?: ReactElement;
   Provider?: ComponentType<PropsWithChildren>;
   UserMenuItems?: ComponentType;
-  i18nProvider?: I18nProvider;
 };

package/src/app/extensions.tsx

@@ -18,20 +18,6 @@ export const extensionRouteElements = appExtensions
   .map((extension) => extension.routes)
   .filter((routes): routes is NonNullable<typeof routes> => Boolean(routes));
 
-const i18nExtensions = appExtensions.filter(
-  (extension) => extension.i18nProvider
-);
-
-if (i18nExtensions.length > 1) {
-  console.warn(
-    `Multiple app extensions provide i18nProvider (${i18nExtensions
-      .map((extension) => extension.id)
-      .join(", ")}). Using ${i18nExtensions[0].id}.`
-  );
-}
-
-export const extensionI18nProvider = i18nExtensions[0]?.i18nProvider;
-
 export const extensionUserMenuItems = appExtensions
   .filter((extension) => extension.UserMenuItems)
   .map((extension) => ({

package/src/components/app-shell/breadcrumb.tsx

@@ -3,9 +3,12 @@
 import { Fragment, useMemo } from "react";
 import { Home } from "lucide-react";
 import {
+  type IResourceItem,
   matchResourceFromRoute,
   useBreadcrumb,
+  useGetToPath,
   useLink,
+  useParsed,
   useResourceParams,
   useTranslate,
   useUserFriendlyName,
@@ -24,9 +27,42 @@ export function Breadcrumb() {
   const Link = useLink();
   const { breadcrumbs } = useBreadcrumb();
   const { resources } = useResourceParams();
+  const { pathname } = useParsed();
+  const getToPath = useGetToPath();
   const translate = useTranslate();
   const getUserFriendlyName = useUserFriendlyName();
   const rootRouteResource = matchResourceFromRoute("/", resources);
+  const resolvedBreadcrumbs = useMemo(() => {
+    if (breadcrumbs.length > 0) return breadcrumbs;
+
+    const closestMatch = findClosestRouteMatch(pathname, resources);
+    if (!closestMatch.resource) return breadcrumbs;
+
+    const items: Array<{ label: string; href?: string }> = [
+      {
+        label:
+          closestMatch.resource.meta?.label ?? closestMatch.resource.name,
+        href: getToPath({ resource: closestMatch.resource, action: "list" }),
+      },
+    ];
+    const nestedAction = getNestedRouteAction(
+      pathname,
+      closestMatch.matchedSegmentCount
+    ) ??
+      (closestMatch.action && closestMatch.action !== "list"
+        ? closestMatch.action
+        : undefined);
+    if (nestedAction) {
+      items.push({
+        label: translate(
+          `buttons.${nestedAction}`,
+          nestedAction.charAt(0).toUpperCase() + nestedAction.slice(1)
+        ),
+      });
+    }
+
+    return items;
+  }, [breadcrumbs, getToPath, pathname, resources, translate]);
 
   const breadCrumbItems = useMemo(() => {
     const list: {
@@ -47,7 +83,7 @@ export function Breadcrumb() {
       ),
     });
 
-    for (const { label, href } of breadcrumbs) {
+    for (const { label, href } of resolvedBreadcrumbs) {
       const matchingResource = resources.find((resource) => {
         const metaLabel = resource.meta?.label;
         return (
@@ -80,9 +116,9 @@ export function Breadcrumb() {
 
     return list;
   }, [
-    breadcrumbs,
     getUserFriendlyName,
     Link,
+    resolvedBreadcrumbs,
     resources,
     rootRouteResource,
     translate,
@@ -114,4 +150,33 @@ export function Breadcrumb() {
   );
 }
 
+function findClosestRouteMatch(
+  pathname: string | undefined,
+  resources: IResourceItem[]
+) {
+  const segments = pathname?.split("/").filter(Boolean) ?? [];
+
+  for (let length = segments.length; length >= 0; length -= 1) {
+    const route = `/${segments.slice(0, length).join("/")}`;
+    const match = matchResourceFromRoute(route, resources);
+    if (match.resource) {
+      return { ...match, matchedSegmentCount: length };
+    }
+  }
+
+  return { resource: undefined, matchedSegmentCount: 0 };
+}
+
+function getNestedRouteAction(
+  pathname: string | undefined,
+  matchedSegmentCount: number
+) {
+  const segments = pathname?.split("/").filter(Boolean) ?? [];
+  const action = segments[matchedSegmentCount];
+
+  return action && ["create", "edit", "show", "clone"].includes(action)
+    ? action
+    : undefined;
+}
+
 Breadcrumb.displayName = "Breadcrumb";

package/src/components/app-shell/sidebar.tsx

@@ -218,7 +218,7 @@ function SidebarDropdownItem({
   selectedKey,
   Link,
 }: MenuItemProps & { Link: ReturnType<typeof useLink> }) {
-  const isSelected = item.key === selectedKey;
+  const isSelected = isTreeItemSelected(item, selectedKey);
   const displayName = useMenuItemLabel(item);
 
   return (
@@ -239,7 +239,7 @@ function SidebarDropdownItem({
 }
 
 function SidebarItemLink({ item, selectedKey }: MenuItemProps) {
-  const isSelected = item.key === selectedKey;
+  const isSelected = isTreeItemSelected(item, selectedKey);
 
   return <SidebarButton item={item} isSelected={isSelected} asLink={true} />;
 }

package/src/components/resources/views/list-view.tsx

@@ -11,12 +11,13 @@ import { cn } from "@/lib/utils";
 
 type ListViewProps = PropsWithChildren<{
   className?: string;
+  resource?: string;
 }>;
 
-export function ListView({ children, className }: ListViewProps) {
+export function ListView({ children, className, resource }: ListViewProps) {
   return (
     <div className={cn("flex flex-col", "gap-6", className)}>
-      <ListViewHeader />
+      <ListViewHeader resource={resource} />
       {children}
     </div>
   );