@nocobase/portal-template-default 1.0.9 → 1.0.11

package/{registry → src/extensions}/nocobase-ai/providers/use-chat-work-context.ts

@@ -74,8 +74,11 @@ export function useChatWorkContext(activeConversationId: string) {
   );
 
   const clearWorkContext = useCallback(() => setDrafts({}), []);
+  // Shared EMPTY_CONTEXT rather than a fresh `[]` — see getConversationAttachments: the send path
+  // compares this by identity across an await, so a new array each call would read as "the user
+  // changed the work context" and silently abort every send.
   const getConversationWorkContext = useCallback(
-    (conversationId: string) => draftsRef.current[conversationId] ?? [],
+    (conversationId: string) => draftsRef.current[conversationId] ?? EMPTY_CONTEXT,
     []
   );
   const workContext = drafts[activeConversationId] ?? EMPTY_CONTEXT;

package/{registry → src/extensions}/nocobase-route-surfaces/README.md

@@ -3,7 +3,8 @@
 Route surfaces keep URL navigation separate from visual presentation. The same
 business content can be hosted by a routed drawer, dialog, or full page.
 
-The Registry also installs a lazy-loaded Demo route at `/route-surfaces` with
+In development, the Registry also installs a lazy-loaded Demo route at
+`/dev/route-surfaces` with
 live drawer, dialog, child-page, nested-drawer, and mixed page/drawer/dialog
 scenarios plus a Prompt generator.
 

package/{registry → src/extensions}/nocobase-route-surfaces/demo/index.tsx

@@ -1,9 +1,15 @@
 import { ArrowLeft, ArrowRight, Layers3 } from "lucide-react";
-import { useOutlet, useNavigate } from "react-router";
+import { useLocation, useOutlet, useNavigate } from "react-router";
 
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card";
 import {
   RouteDialog,
   RouteDrawer,
@@ -13,7 +19,16 @@ import {
 import { RouteSurfacePromptGenerator } from "./prompt-generator";
 import { routeSurfaceScenarios } from "./scenarios";
 
-const demoBase = "/route-surfaces";
+const routeSurfaceRoot = "/route-surfaces";
+
+function useRouteSurfaceDemoBase() {
+  const { pathname } = useLocation();
+  const rootIndex = pathname.indexOf(routeSurfaceRoot);
+
+  return rootIndex >= 0
+    ? pathname.slice(0, rootIndex + routeSurfaceRoot.length)
+    : routeSurfaceRoot;
+}
 
 export function RouteSurfacesDemoHome() {
   const navigate = useNavigate();
@@ -29,8 +44,8 @@ export function RouteSurfacesDemoHome() {
           </h1>
           <p className="max-w-3xl text-muted-foreground">
             Keep business content independent from whether it appears as a page,
-            drawer, dialog, or nested combination. Every preview below supports a
-            direct URL and browser history.
+            drawer, dialog, or nested combination. Every preview below supports
+            a direct URL and browser history.
           </p>
         </div>
 
@@ -72,6 +87,7 @@ export function RouteSurfacesDemoHome() {
 export function DemoDrawerRoute() {
   const navigate = useNavigate();
   const nested = useOutlet();
+  const demoBase = useRouteSurfaceDemoBase();
 
   return (
     <RouteDrawer
@@ -96,6 +112,8 @@ export function DemoDrawerRoute() {
 }
 
 export function DemoSecondDrawerRoute() {
+  const demoBase = useRouteSurfaceDemoBase();
+
   return (
     <RouteDrawer
       title="Renewal activity"
@@ -113,6 +131,8 @@ export function DemoSecondDrawerRoute() {
 }
 
 export function DemoDialogRoute() {
+  const demoBase = useRouteSurfaceDemoBase();
+
   return (
     <RouteDialog
       title="Approve renewal"
@@ -131,6 +151,7 @@ export function DemoDialogRoute() {
 
 export function DemoPageRoute() {
   const nested = useOutlet();
+  const demoBase = useRouteSurfaceDemoBase();
 
   return (
     <RoutePage closeTo={demoBase}>
@@ -153,7 +174,8 @@ function DemoPageContent({ nested }: { nested: React.ReactNode }) {
               Customer workspace
             </h1>
             <p className="text-muted-foreground">
-              This route replaces the Demo home instead of rendering inside its Outlet.
+              This route replaces the Demo home instead of rendering inside its
+              Outlet.
             </p>
           </div>
           <Button variant="outline" onClick={() => void close()}>
@@ -169,7 +191,8 @@ function DemoPageContent({ nested }: { nested: React.ReactNode }) {
               <CardTitle>Page-owned workflow</CardTitle>
             </div>
             <CardDescription>
-              A page can still host routed overlays without becoming coupled to their content.
+              A page can still host routed overlays without becoming coupled to
+              their content.
             </CardDescription>
           </CardHeader>
           <CardContent>
@@ -185,6 +208,7 @@ function DemoPageContent({ nested }: { nested: React.ReactNode }) {
 export function DemoPageDrawerRoute() {
   const navigate = useNavigate();
   const nested = useOutlet();
+  const demoBase = useRouteSurfaceDemoBase();
 
   return (
     <RouteDrawer
@@ -209,6 +233,8 @@ export function DemoPageDrawerRoute() {
 }
 
 export function DemoPageDrawerDialogRoute() {
+  const demoBase = useRouteSurfaceDemoBase();
+
   return (
     <RouteDialog
       title="Confirm follow-up"

package/{registry → src/extensions}/nocobase-route-surfaces/demo/scenarios.ts

@@ -19,40 +19,45 @@ export const routeSurfaceScenarios: RouteSurfaceScenario[] = [
     id: "drawer",
     number: "1",
     title: "Drawer route",
-    description: "Keep the current page mounted and open one URL-backed drawer.",
-    path: "/route-surfaces/drawer",
+    description:
+      "Keep the current page mounted and open one URL-backed drawer.",
+    path: "drawer",
     routeShape: "Page → Drawer",
   },
   {
     id: "dialog",
     number: "2",
     title: "Dialog route",
-    description: "Open focused content in a modal while preserving the page URL history.",
-    path: "/route-surfaces/dialog",
+    description:
+      "Open focused content in a modal while preserving the page URL history.",
+    path: "dialog",
     routeShape: "Page → Dialog",
   },
   {
     id: "page",
     number: "3",
     title: "Child page",
-    description: "Replace the current page instead of rendering the child inside an overlay.",
-    path: "/route-surfaces/page",
+    description:
+      "Replace the current page instead of rendering the child inside an overlay.",
+    path: "page",
     routeShape: "Page → Child page",
   },
   {
     id: "nested-drawers",
     number: "4",
     title: "Second-level drawer",
-    description: "Push the lower drawer outward and keep the top drawer at a stable size.",
-    path: "/route-surfaces/drawer/second",
+    description:
+      "Push the lower drawer outward and keep the top drawer at a stable size.",
+    path: "drawer/second",
     routeShape: "Page → Drawer → Drawer",
   },
   {
     id: "page-drawer-dialog",
     number: "5",
     title: "Page, drawer, and dialog",
-    description: "Compose different presentation types without coupling business content to them.",
-    path: "/route-surfaces/page/drawer/dialog",
+    description:
+      "Compose different presentation types without coupling business content to them.",
+    path: "page/drawer/dialog",
     routeShape: "Child page → Drawer → Dialog",
   },
 ];
@@ -66,15 +71,16 @@ export function getRouteSurfacePrompt(
       "Keep the current page mounted and open the target content with RouteDrawer. Closing the drawer returns to the page route.",
     dialog:
       "Keep the current page mounted and open the target content with RouteDialog. The dialog route must be directly addressable and dismissible through the shared close lifecycle.",
-    page:
-      "Render the target content as a real child page with RoutePage. Register it as a page route branch rather than placing it inside a drawer outlet.",
+    page: "Render the target content as a real child page with RoutePage. Register it as a page route branch rather than placing it inside a drawer outlet.",
     "nested-drawers":
       "Create a parent RouteDrawer with an Outlet and pass the rendered child outlet through its nested prop. The second RouteDrawer must push the lower drawer outward, keep equal widths, and close back to the parent route.",
     "page-drawer-dialog":
       "Render a RoutePage first, place a RouteDrawer route inside that page, then render a RouteDialog as the drawer's nested route. Closing each layer must return to the immediately lower URL.",
   }[scenario.id];
 
-  return `Build ${target || "the requested workflow"} with the installed NocoBase route surfaces.
+  return `Build ${
+    target || "the requested workflow"
+  } with the installed NocoBase route surfaces.
 
 Scenario:
 - ${scenario.routeShape}
@@ -89,7 +95,7 @@ Implementation requirements:
 - A full child page must be a page route branch, not an Outlet rendered inside a drawer.
 - For editable forms, use useRefineUnsavedChangesGuard, pass its beforeClose callback to the surface, render its confirmation node, and use useRouteSurfaceClose for Cancel and successful submission.
 - Direct URL entry, refresh, browser back/forward, Escape, the close button, and backdrop dismissal must all restore the correct layer stack.
-- Apply ResourceAccessGuard to each business resource/action independently; do not rely on a parent list permission for unrelated child pages.
+- Apply Refine CanAccess with an AccessDenied fallback to each business resource/action independently; do not rely on a parent list permission for unrelated child pages.
 
 Deliver the complete route definitions and React components using the application's existing design system.`;
 }

package/{registry → src/extensions}/nocobase-route-surfaces/extension.tsx

@@ -36,84 +36,87 @@ const DemoPageDrawerDialog = lazy(() =>
 
 const routeSurfacesExtension: AppExtension = {
   id: "nocobase-route-surfaces",
-  resources: [
-    {
-      name: "route-surfaces",
-      list: "/route-surfaces",
-      meta: {
-        label: "Route surfaces",
-        icon: <Layers3 />,
-        description: "URL-backed drawer, dialog, page, and nested route patterns.",
-        acl: { type: "authenticated" },
+  dev: {
+    resources: [
+      {
+        name: "route-surfaces",
+        list: "route-surfaces",
+        meta: {
+          label: "Route surfaces",
+          icon: <Layers3 />,
+          description:
+            "URL-backed drawer, dialog, page, and nested route patterns.",
+          acl: { type: "authenticated" },
+        },
       },
-    },
-  ],
-  routes: (
-    <>
-      <Route
-        key="route-surfaces-overlays"
-        path="/route-surfaces"
-        element={
-          <LazyRouteSurfaceDemo>
-            <DemoHome />
-          </LazyRouteSurfaceDemo>
-        }
-      >
+    ],
+    routes: (
+      <>
         <Route
-          path="drawer"
+          key="route-surfaces-overlays"
+          path="route-surfaces"
           element={
             <LazyRouteSurfaceDemo>
-              <DemoDrawer />
+              <DemoHome />
             </LazyRouteSurfaceDemo>
           }
         >
           <Route
-            path="second"
+            path="drawer"
             element={
               <LazyRouteSurfaceDemo>
-                <DemoSecondDrawer />
+                <DemoDrawer />
+              </LazyRouteSurfaceDemo>
+            }
+          >
+            <Route
+              path="second"
+              element={
+                <LazyRouteSurfaceDemo>
+                  <DemoSecondDrawer />
+                </LazyRouteSurfaceDemo>
+              }
+            />
+          </Route>
+          <Route
+            path="dialog"
+            element={
+              <LazyRouteSurfaceDemo>
+                <DemoDialog />
               </LazyRouteSurfaceDemo>
             }
           />
         </Route>
         <Route
-          path="dialog"
+          key="route-surfaces-page"
+          path="route-surfaces/page"
           element={
             <LazyRouteSurfaceDemo>
-              <DemoDialog />
-            </LazyRouteSurfaceDemo>
-          }
-        />
-      </Route>
-      <Route
-        key="route-surfaces-page"
-        path="/route-surfaces/page"
-        element={
-          <LazyRouteSurfaceDemo>
-            <DemoPage />
-          </LazyRouteSurfaceDemo>
-        }
-      >
-        <Route
-          path="drawer"
-          element={
-            <LazyRouteSurfaceDemo>
-              <DemoPageDrawer />
+              <DemoPage />
             </LazyRouteSurfaceDemo>
           }
         >
           <Route
-            path="dialog"
+            path="drawer"
             element={
               <LazyRouteSurfaceDemo>
-                <DemoPageDrawerDialog />
+                <DemoPageDrawer />
               </LazyRouteSurfaceDemo>
             }
-          />
+          >
+            <Route
+              path="dialog"
+              element={
+                <LazyRouteSurfaceDemo>
+                  <DemoPageDrawerDialog />
+                </LazyRouteSurfaceDemo>
+              }
+            />
+          </Route>
         </Route>
-      </Route>
-    </>
-  ),
+      </>
+    ),
+  },
 };
 
 export default routeSurfacesExtension;

package/src/{pages/users → extensions/nocobase-users-example}/create.tsx

@@ -4,7 +4,7 @@ import { useMemo } from "react";
 
 import { Button } from "@/components/ui/button";
 import { Form } from "@/components/ui/form";
-import { useAIForm, type AIFormField } from "@/extensions/nocobase-ai";
+import { useAIForm, type AIFormField } from "./optional-ai";
 import {
   RouteDrawer,
   RouteDrawerFooter,
@@ -60,7 +60,7 @@ function UserCreateForm() {
       action: "create",
       redirect: false,
       onMutationSuccess: () => {
-        void close({ skipBeforeClose: true });
+        close({ skipBeforeClose: true });
       },
     },
     defaultValues: {
@@ -90,11 +90,11 @@ function UserCreateForm() {
         onSubmit={form.handleSubmit((values) => onFinish(values))}
         className="flex min-h-0 flex-1 flex-col"
       >
-        <div className="resource-form min-h-0 flex-1 overflow-y-auto px-5 py-5">
+        <div className="min-h-0 flex-1 space-y-6 overflow-y-auto px-5 py-5 [&_[data-slot=input]]:h-10 [&_[data-slot=select-trigger]]:h-10 [&_[data-slot=textarea]]:min-h-56">
           <UserFormFields form={form} includePassword translate={translate} />
         </div>
         <RouteDrawerFooter className="flex-row justify-end">
-          <Button type="button" variant="outline" onClick={() => void close()}>
+          <Button type="button" variant="outline" onClick={() => close()}>
             {translate("users.form.cancel", { ns: "app" }, "Cancel")}
           </Button>
           <Button

package/src/{pages/users → extensions/nocobase-users-example}/edit.tsx

@@ -5,7 +5,7 @@ import { useParams } from "react-router";
 
 import { Button } from "@/components/ui/button";
 import { Form } from "@/components/ui/form";
-import { useAIForm, type AIFormField } from "@/extensions/nocobase-ai";
+import { useAIForm, type AIFormField } from "./optional-ai";
 import {
   RouteDrawer,
   RouteDrawerFooter,
@@ -35,11 +35,7 @@ export const UserEdit = ({
   return (
     <>
       <RouteDrawer
-        title={translate(
-          "users.drawer.edit.title",
-          { ns: "app" },
-          "Edit user"
-        )}
+        title={translate("users.drawer.edit.title", { ns: "app" }, "Edit user")}
         description={translate(
           "users.drawer.edit.description",
           { ns: "app" },
@@ -69,7 +65,7 @@ function UserEditForm({ id }: { id?: string }) {
       id,
       redirect: false,
       onMutationSuccess: () => {
-        void close({ skipBeforeClose: true });
+        close({ skipBeforeClose: true });
       },
     },
   });
@@ -92,11 +88,11 @@ function UserEditForm({ id }: { id?: string }) {
         onSubmit={form.handleSubmit((values) => onFinish(values))}
         className="flex min-h-0 flex-1 flex-col"
       >
-        <div className="resource-form min-h-0 flex-1 overflow-y-auto px-5 py-5">
+        <div className="min-h-0 flex-1 space-y-6 overflow-y-auto px-5 py-5 [&_[data-slot=input]]:h-10 [&_[data-slot=select-trigger]]:h-10 [&_[data-slot=textarea]]:min-h-56">
           <UserFormFields form={form} translate={translate} />
         </div>
         <RouteDrawerFooter className="flex-row justify-end">
-          <Button type="button" variant="outline" onClick={() => void close()}>
+          <Button type="button" variant="outline" onClick={() => close()}>
             {translate("users.form.cancel", { ns: "app" }, "Cancel")}
           </Button>
           <Button

package/src/extensions/nocobase-users-example/extension.tsx

@@ -0,0 +1,109 @@
+import { CanAccess } from "@/components/access-control/can-access";
+import { UsersRound } from "lucide-react";
+import { Route } from "react-router";
+
+import type { AppExtension } from "@/app/extension";
+import { AccessDenied } from "@/components/access-control/access-denied";
+import { UserCreate } from "./create";
+import { UserEdit } from "./edit";
+import { UserResourceLayout } from "./layout";
+import { RoleDetailRoute } from "./role-detail";
+import { userRoutes } from "./routes";
+import { UserShow } from "./show";
+import "./locales";
+
+const usersExampleExtension: AppExtension = {
+  id: "nocobase-users-example",
+  priority: 0,
+  resources: [
+    {
+      name: "users",
+      list: userRoutes.list,
+      create: userRoutes.create,
+      edit: userRoutes.edit,
+      show: userRoutes.show,
+      meta: {
+        label: "Users",
+        priority: 1,
+        singularLabel: "User",
+        i18nKey: "resources.users",
+        i18nSingularKey: "resources.user",
+        i18nOptions: { ns: "app" },
+        descriptionI18nKey: "resources.users.description",
+        icon: <UsersRound />,
+        description:
+          "Manage the people who can sign in and work in this NocoBase application.",
+        canCreate: true,
+        canDelete: true,
+        acl: { type: "collection" },
+      },
+    },
+  ],
+  routes: (
+    <Route path="/users" element={<UserResourceLayout />}>
+      <Route
+        path="create"
+        element={
+          <CanAccess
+            resource="users"
+            action="create"
+            fallback={<AccessDenied />}
+          >
+            <UserCreate />
+          </CanAccess>
+        }
+      />
+      <Route
+        path="edit/:id"
+        element={
+          <CanAccess resource="users" action="edit" fallback={<AccessDenied />}>
+            <UserEdit />
+          </CanAccess>
+        }
+      />
+      <Route
+        path="roles/:roleName"
+        element={
+          <CanAccess resource="roles" action="show" fallback={<AccessDenied />}>
+            <RoleDetailRoute returnTo="list" />
+          </CanAccess>
+        }
+      />
+      <Route
+        path="show/:id"
+        element={
+          <CanAccess resource="users" action="show" fallback={<AccessDenied />}>
+            <UserShow />
+          </CanAccess>
+        }
+      >
+        <Route
+          path="edit"
+          element={
+            <CanAccess
+              resource="users"
+              action="edit"
+              fallback={<AccessDenied />}
+            >
+              <UserEdit returnTo="show" />
+            </CanAccess>
+          }
+        />
+        <Route
+          path="roles/:roleName"
+          element={
+            <CanAccess
+              resource="roles"
+              action="show"
+              fallback={<AccessDenied />}
+            >
+              <RoleDetailRoute returnTo="show" />
+            </CanAccess>
+          }
+        />
+      </Route>
+    </Route>
+  ),
+};
+
+export default usersExampleExtension;

package/src/{pages/users → extensions/nocobase-users-example}/form-context.ts

@@ -1,7 +1,6 @@
 import type { useTranslate } from "@refinedev/core";
-import type { UseFormReturn } from "react-hook-form";
+import type { Path, PathValue, UseFormReturn } from "react-hook-form";
 
-import { applyReactHookFormValues } from "@/extensions/nocobase-ai/adapters/react-hook-form";
 import type { UserFormValues } from "./types";
 
 type Translate = ReturnType<typeof useTranslate>;
@@ -18,14 +17,17 @@ export function applyAIUserFormValues(
   form: Pick<UseFormReturn<UserFormValues>, "setValue">,
   values: Record<string, unknown>
 ) {
-  applyReactHookFormValues(
-    form,
-    Object.fromEntries(
-      Object.entries(values).filter(([name]) =>
-        AI_EDITABLE_FIELDS.includes(name as (typeof AI_EDITABLE_FIELDS)[number])
-      )
-    )
+  const editableValues = Object.entries(values).filter(([name]) =>
+    AI_EDITABLE_FIELDS.includes(name as (typeof AI_EDITABLE_FIELDS)[number])
   );
+  for (const [name, value] of editableValues) {
+    const path = name as Path<UserFormValues>;
+    form.setValue(path, value as PathValue<UserFormValues, typeof path>, {
+      shouldDirty: true,
+      shouldTouch: true,
+      shouldValidate: true,
+    });
+  }
 }
 
 export function getAIUserFormFields(translate: Translate) {

package/src/extensions/nocobase-users-example/layout.tsx

@@ -0,0 +1,16 @@
+import { CanAccess } from "@/components/access-control/can-access";
+import { Outlet } from "react-router";
+
+import { AccessDenied } from "@/components/access-control/access-denied";
+import { UserList } from "./list";
+
+export function UserResourceLayout() {
+  return (
+    <>
+      <CanAccess resource="users" action="list" fallback={<AccessDenied />}>
+        <UserList />
+      </CanAccess>
+      <Outlet />
+    </>
+  );
+}

package/src/{pages/users → extensions/nocobase-users-example}/list.tsx

@@ -15,7 +15,7 @@ import { DeleteButton } from "@/components/resources/buttons/delete";
 import { EditButton } from "@/components/resources/buttons/edit";
 import { ShowButton } from "@/components/resources/buttons/show";
 import { ListView } from "@/components/resources/views/list-view";
-import { useAIPageElementHandle } from "@/extensions/nocobase-ai";
+import { useAIPageElementHandle } from "./optional-ai";
 import type { Role } from "@/lib/nocobase/acl";
 import { RoleBadges } from "./role-badges";
 import { resolveRoleLabel } from "./role-utils";