@nocobase/app-template-default 1.0.0-beta.80 → 1.0.0-beta.82

package/client/extensions/nocobase-file-component-ui/locales/vi-VN.ts

@@ -0,0 +1,47 @@
+import type { FileUiResource } from './en-US.js';
+const messages = {
+  'files.ooxmlLoadFailed': 'Không thể hiển thị tệp Office Open XML này.',
+  'files.ooxmlLoadTimedOut':
+    'Bản xem trước không tải xong trong vòng {{minutes}} phút.',
+  'files.previewRequestFailed':
+    'Yêu cầu xem trước không thành công ({{status}}).',
+  uploadFailed: 'Tải lên tệp không thành công.',
+  fileLimitReached: 'Đã đạt đến số lượng tệp tối đa.',
+  fileTooLarge: 'Tệp vượt quá kích thước tối đa.',
+  fileTypeNotAllowed: 'Loại tệp không được phép.',
+  removalFailed: 'Xóa tệp không thành công.',
+  urlNotAllowed: 'Tệp URL không được phép.',
+  downloadFailed: 'Tải xuống tệp không thành công.',
+  invalidUrl: 'Tệp URL bị thiếu hoặc không được phép.',
+  pdfPreviewFailed: 'Không thể tải bản xem trước PDF.',
+  pdfPreviewMarkup: 'Tệp URL trả về HTML hoặc XML thay vì PDF.',
+  previewFailed: 'Không thể tải bản xem trước tệp.',
+  'files.empty': 'Không có tập tin.',
+  'files.preview': 'Xem trước',
+  'files.download': 'Tải xuống',
+  'files.remove': 'Loại bỏ',
+  'files.chooseMany': 'Chọn tập tin',
+  'files.chooseOne': 'Chọn tập tin',
+  'files.retry': 'Thử lại',
+  'files.done': 'Hoàn thành',
+  'files.uploading': 'Đang tải lên',
+  'files.failed': 'Thất bại',
+  'files.pending': 'Đang chờ',
+  'files.previous': 'Tệp trước đó',
+  'files.next': 'Tập tin tiếp theo',
+  'files.loadingPreview': 'Đang tải bản xem trước...',
+  'files.downloadFile': 'Tải tập tin',
+  'files.previewUnavailable': 'Bản xem trước không khả dụng cho loại tệp này.',
+  'files.imageFailed':
+    'Không thể hiển thị hình ảnh này. Nó có thể bị hỏng hoặc ở định dạng không được hỗ trợ.',
+  'files.officeFailed': 'Office Online không thể tải tệp này.',
+  'files.officeUrl':
+    'Office Online yêu cầu tệp tuyệt đối có thể truy cập internet URL.',
+  'files.cancelFile': 'Hủy {{filename}}',
+  'files.status.uploading': 'Đang tải lên',
+  'files.status.pending': 'Đang chờ',
+  'files.status.error': 'Thất bại',
+};
+
+const resource: FileUiResource = { fileUi: messages };
+export default resource;

package/client/extensions/nocobase-file-component-ui/locales/zh-CN.ts

@@ -0,0 +1,43 @@
+import type { FileUiResource } from './en-US.js';
+const messages = {
+  'files.ooxmlLoadFailed': '无法渲染此 Office Open XML 文件。',
+  'files.ooxmlLoadTimedOut': '预览未能在 {{minutes}} 分钟内加载完成。',
+  'files.previewRequestFailed': '预览请求失败（{{status}}）。',
+  uploadFailed: '文件上传失败。',
+  fileLimitReached: '已达到文件数量上限。',
+  fileTooLarge: '文件超出大小限制。',
+  fileTypeNotAllowed: '不允许上传此文件类型。',
+  removalFailed: '文件删除失败。',
+  urlNotAllowed: '不允许访问此文件 URL。',
+  downloadFailed: '文件下载失败。',
+  invalidUrl: '文件 URL 缺失或不允许访问。',
+  pdfPreviewFailed: '无法加载 PDF 预览。',
+  pdfPreviewMarkup: '文件 URL 返回的是 HTML 或 XML，而不是 PDF。',
+  previewFailed: '无法加载文件预览。',
+  'files.empty': '暂无文件。',
+  'files.preview': '预览',
+  'files.download': '下载',
+  'files.remove': '移除',
+  'files.chooseMany': '选择文件',
+  'files.chooseOne': '选择文件',
+  'files.retry': '重试',
+  'files.done': '已完成',
+  'files.uploading': '正在上传',
+  'files.failed': '失败',
+  'files.pending': '等待中',
+  'files.previous': '上一个文件',
+  'files.next': '下一个文件',
+  'files.loadingPreview': '正在加载预览…',
+  'files.downloadFile': '下载文件',
+  'files.previewUnavailable': '此文件类型不支持预览。',
+  'files.imageFailed': '无法显示此图片，文件可能已损坏或格式不受支持。',
+  'files.officeFailed': 'Office Online 无法加载此文件。',
+  'files.officeUrl': 'Office Online 需要可通过互联网访问的文件绝对地址。',
+  'files.cancelFile': '取消 {{filename}}',
+  'files.status.uploading': '正在上传',
+  'files.status.pending': '等待中',
+  'files.status.error': '失败',
+};
+
+const resource: FileUiResource = { fileUi: messages };
+export default resource;

package/client/extensions/nocobase-file-component-ui/locales/zh-TW.ts

@@ -0,0 +1,43 @@
+import type { FileUiResource } from './en-US.js';
+const messages = {
+  'files.ooxmlLoadFailed': '無法呈現此 Office Open XML 檔案。',
+  'files.ooxmlLoadTimedOut': '預覽未在 {{minutes}} 分鐘內完成載入。',
+  'files.previewRequestFailed': '預覽請求失敗 ({{status}})。',
+  uploadFailed: '檔案上傳失敗。',
+  fileLimitReached: '已達到最大檔案數。',
+  fileTooLarge: '檔案超出最大大小。',
+  fileTypeNotAllowed: '不允許的檔案型別。',
+  removalFailed: '檔案刪除失敗。',
+  urlNotAllowed: '不允許使用檔案 URL。',
+  downloadFailed: '檔案下載失敗。',
+  invalidUrl: '檔案 URL 遺失或不允許。',
+  pdfPreviewFailed: '無法載入 PDF 預覽。',
+  pdfPreviewMarkup: '檔案 URL 傳回 HTML 或 XML，而不是 PDF。',
+  previewFailed: '無法載入檔案預覽。',
+  'files.empty': '沒有檔案。',
+  'files.preview': '預覽',
+  'files.download': '下載',
+  'files.remove': '刪除',
+  'files.chooseMany': '選擇檔案',
+  'files.chooseOne': '選擇檔案',
+  'files.retry': '重試',
+  'files.done': '已完成',
+  'files.uploading': '上傳中',
+  'files.failed': '失敗',
+  'files.pending': '待處理',
+  'files.previous': '上一個檔案',
+  'files.next': '下一個檔案',
+  'files.loadingPreview': '載入預覽...',
+  'files.downloadFile': '下載檔案',
+  'files.previewUnavailable': '此檔案型別無法預覽。',
+  'files.imageFailed': '此影像無法顯示。它可能已損壞或格式不受支援。',
+  'files.officeFailed': 'Office Online 無法載入此檔案。',
+  'files.officeUrl': 'Office Online 需要可透過 Internet 存取的絕對檔案 URL。',
+  'files.cancelFile': '取消 {{filename}}',
+  'files.status.uploading': '上傳中',
+  'files.status.pending': '待處理',
+  'files.status.error': '失敗',
+};
+
+const resource: FileUiResource = { fileUi: messages };
+export default resource;

package/client/extensions/nocobase-file-component-ui/types.ts

@@ -17,7 +17,7 @@ export interface FileUiLabels {
 }
 
 export interface FileUploadFieldProps {
-  readonly repository: ClientFileRepository;
+  readonly repository: Pick<ClientFileRepository, 'uploadOne' | 'deleteOne'>;
   readonly value: readonly FileRecord[];
   readonly onChange: (value: readonly FileRecord[]) => void;
   readonly onError?: (error: Error) => void;
@@ -47,6 +47,8 @@ export interface FilePreviewDialogProps {
   readonly initialIndex?: number;
   readonly open: boolean;
   readonly onOpenChange: (open: boolean) => void;
+  /** Override downloads for both the toolbar and preview fallbacks. */
+  readonly onDownload?: (file: FileRecord) => void | Promise<void>;
   readonly onError?: (error: Error) => void;
   readonly download?: boolean;
   readonly labels?: FileUiLabels;

package/client/locales/en-US.ts

@@ -1,3 +1,4 @@
+import fileUi from '../extensions/nocobase-file-component-ui/locales/en-US.js';
 import type { LocaleResource } from '@nocobase/i18n';
 
 import systemEnUS from './system/en-US.js';
@@ -6,6 +7,7 @@ const enUS = {
   // The template's own copy: the shell, the sign-in pages, shared components and the homepage. Keep it in
   // `./system/` so a template upgrade can replace it without touching the application's copy below.
   ...systemEnUS,
+  ...fileUi,
   // The application's copy goes here, one group per feature. A shared group such as `navigation` is extended by
   // spreading the system one first, `navigation: { ...systemEnUS.navigation, orders: 'Orders' }`, since a group
   // written here replaces the system group of the same name rather than merging with it.

package/client/locales/system/settings-en-US.ts

@@ -148,6 +148,9 @@ const settings = {
     'Contact an administrator to add users or grant the permissions needed to create users and assign roles.',
   rolesReadOnlyEmpty:
     'Contact an administrator to create a role or grant you permission to create roles.',
+  noRoleAccess:
+    'This user can still sign in and use account basics. No business access is granted by roles.',
+  noAssignedRoles: 'No assigned roles',
   noRoles: 'No roles yet',
   create: 'Create',
   edit: 'Edit',

package/client/locales/system/settings-zh-CN.ts

@@ -136,6 +136,8 @@ const settings = {
   usersReadOnlyEmpty:
     '请联系管理员添加用户，或授予创建用户和分配角色所需的权限。',
   rolesReadOnlyEmpty: '请联系管理员创建角色，或授予你创建角色的权限。',
+  noRoleAccess: '此用户仍可登录并使用账号基础功能，角色未授予业务访问。',
+  noAssignedRoles: '未分配角色',
   noRoles: '暂无角色',
   create: '创建',
   edit: '编辑',

package/client/locales/zh-CN.ts

@@ -1,9 +1,11 @@
+import fileUi from '../extensions/nocobase-file-component-ui/locales/zh-CN.js';
 import type { AppResource } from './en-US.js';
 import systemZhCN from './system/zh-CN.js';
 
 const zhCN: AppResource = {
   // The template's own copy; see `./en-US.ts`.
   ...systemZhCN,
+  ...fileUi,
 };
 
 export default zhCN;

package/client/pages/settings/role-form.tsx

@@ -31,6 +31,7 @@ import {
   useNavigate,
   useOutletContext,
   useParams,
+  useResolvedPath,
 } from 'react-router';
 import { RouteChildPage } from '#components/route-child-page';
 import { BackButton } from '#components/back-button';
@@ -122,7 +123,10 @@ function RoleEditor(): ReactElement {
     : canUpdate &&
       (!request.data?.data.protection ||
         request.data.data.protection.allow.includes('update'));
-  const closeTo = { pathname: '/settings/roles', search: location.search };
+  const closeTo = {
+    pathname: useResolvedPath('..').pathname,
+    search: location.search,
+  };
   const save = async (event: React.FormEvent<HTMLFormElement>) => {
     event.preventDefault();
     if (options.error || !catalog || (!creating && request.error)) return;

package/client/pages/settings/user-form.tsx

@@ -174,6 +174,11 @@ export function RoleSelection({
           </ComboboxList>
         </ComboboxContent>
       </Combobox>
+      {scope.key === 'app' && selected.length === 0 && (
+        <p className='text-sm text-muted-foreground'>
+          {t('settings.noRoleAccess')}
+        </p>
+      )}
     </div>
   );
 }
@@ -223,7 +228,14 @@ function UserEditor(): ReactElement {
     password: '',
   };
   const [roleDraft, setRoleDraft] = useState<Record<string, UserRoleValue>>({});
-  const roles = { ...(initial?.roleScopes ?? {}), ...roleDraft };
+  const defaults = creating
+    ? Object.fromEntries(
+        (options.data?.data.roleScopes ?? [])
+          .filter((scope) => scope.defaultValue !== undefined)
+          .map((scope) => [scope.key, scope.defaultValue!]),
+      )
+    : {};
+  const roles = { ...defaults, ...(initial?.roleScopes ?? {}), ...roleDraft };
   const changedRoles = Object.fromEntries(
     Object.entries(roleDraft).filter(
       ([key, value]) =>

package/client/pages/settings/users.tsx

@@ -360,7 +360,7 @@ export default function UsersPage(): ReactElement {
                 },
               );
             })
-            .join(', ') || '—',
+            .join(', ') || t('settings.noAssignedRoles'),
       },
       {
         id: 'actions',

package/client/routing/route-context.tsx

@@ -4,6 +4,7 @@ import {
   createContext,
   useContext,
   useMemo,
+  useState,
   type PropsWithChildren,
   type ReactElement,
 } from 'react';
@@ -26,6 +27,15 @@ export interface RouteTrailEntry {
   readonly pathname: string;
 }
 
+const RouteSearchContext = createContext<ReadonlyMap<string, string>>(
+  new Map(),
+);
+
+/** Queries belong to the page that was visited, never to a child currently covering it. */
+export function useRouteSearches(): ReadonlyMap<string, string> {
+  return useContext(RouteSearchContext);
+}
+
 const RouteTreeContext = createContext<readonly AppClientRegisteredRoute[]>([]);
 export interface RouteTreeProviderProps extends PropsWithChildren {
   readonly routes: readonly AppClientRegisteredRoute[];
@@ -42,9 +52,31 @@ export function RouteTreeProvider({
   children,
   routes,
 }: RouteTreeProviderProps): ReactElement {
+  const location = useLocation();
+  const pathname = location.pathname.replace(/\/+$/u, '') || '/';
+  const search = location.search;
+  const [visited, setVisited] = useState(() => ({
+    pathname,
+    search,
+    queries: new Map([[pathname, search]]),
+  }));
+  let queries = visited.queries;
+  if (visited.pathname !== pathname || visited.search !== search) {
+    // Keep only the active ancestry. A fresh visit (including an empty query) replaces its old state.
+    // Derive before rendering children so a detail never records its parameters against the parent.
+    queries = new Map(
+      [...queries].filter(([path]) =>
+        pathname.startsWith(`${path.replace(/\/$/u, '')}/`),
+      ),
+    );
+    queries.set(pathname, search);
+    setVisited({ pathname, search, queries });
+  }
   return (
     <RouteTreeContext.Provider value={routes}>
-      {children}
+      <RouteSearchContext.Provider value={queries}>
+        {children}
+      </RouteSearchContext.Provider>
     </RouteTreeContext.Provider>
   );
 }

package/eslint.config.js

@@ -7,5 +7,7 @@ export default createApplicationConfig({
     'client-old/**',
     'public/r/**',
     'storage/**',
+    // Internal workspace packages own their lint and TypeScript configurations.
+    'packages/**',
   ],
 });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nocobase/app-template-default",
   "displayName": "Default Template",
-  "version": "1.0.0-beta.80",
+  "version": "1.0.0-beta.82",
   "type": "module",
   "prettier": "@nocobase/dev-config/prettier",
   "engines": {
@@ -9,7 +9,7 @@
   },
   "nocobase": {
     "templateKind": "app",
-    "defaultTemplateVersion": "1.0.0-beta.80"
+    "defaultTemplateVersion": "1.0.0-beta.82"
   },
   "devDependencies": {
     "@ai-sdk/react": "4.0.131",
@@ -75,7 +75,7 @@
     "@types/jsdom": "^30.0.0",
     "@nocobase/app-client": "^4.0.0-beta.3",
     "@nocobase/app-plugin-template-print": "0.0.2-beta.2",
-    "@nocobase/app-skills": "0.1.0-beta.50",
+    "@nocobase/app-skills": "0.1.0-beta.52",
     "@nocobase/app-testing": "0.1.0-beta.6",
     "@nocobase/app-websocket": "^0.1.0-beta.1",
     "@nocobase/dev-config": "0.1.0-beta.25",
@@ -113,7 +113,8 @@
     "AGENTS.md",
     ".agents/rules",
     "CLAUDE.md",
-    "playwright.config.ts"
+    "playwright.config.ts",
+    "scripts/check-packages.mjs"
   ],
   "publishConfig": {
     "access": "public"
@@ -140,38 +141,38 @@
     "@oclif/core": "^4.14.0",
     "better-auth": "1.7.5",
     "hono": "^4.13.2",
-    "@nocobase/app-plugin-agents": "^1.0.0-beta.25",
-    "@nocobase/app-plugin-api-keys": "^1.0.0-beta.18",
-    "@nocobase/app-plugin-authentication": "^2.0.0-beta.14",
-    "@nocobase/app-plugin-authorization": "^1.0.0-beta.31",
-    "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.16",
-    "@nocobase/app-plugin-foundation": "^0.1.0-beta.7",
+    "@nocobase/app-plugin-agents": "^1.0.0-beta.27",
+    "@nocobase/app-plugin-api-keys": "^1.0.0-beta.19",
+    "@nocobase/app-plugin-authentication": "^2.0.0-beta.15",
+    "@nocobase/app-plugin-authorization": "^1.0.0-beta.32",
+    "@nocobase/app-plugin-database-explorer": "^1.0.0-beta.17",
+    "@nocobase/app-plugin-file": "^1.0.0-beta.27",
+    "@nocobase/app-plugin-foundation": "^0.1.0-beta.9",
     "@nocobase/app-plugin-i18n": "^1.0.0-beta.18",
-    "@nocobase/app-plugin-file": "^1.0.0-beta.26",
-    "@nocobase/app-plugin-knowledge": "^0.1.0-beta.12",
+    "@nocobase/app-plugin-knowledge": "^0.1.0-beta.13",
     "@nocobase/app-plugin-mail": "^1.0.0-beta.17",
-    "@nocobase/app-plugin-notification": "^2.0.0-beta.0",
+    "@nocobase/app-plugin-notification": "^2.0.0-beta.1",
     "@nocobase/app-plugin-notification-in-app": "^2.0.0-beta.0",
     "@nocobase/app-plugin-notification-providers": "^1.0.0-beta.15",
     "@nocobase/app-plugin-scheduler": "^1.0.0-beta.20",
-    "@nocobase/app-plugin-users": "^2.0.0-beta.9",
+    "@nocobase/app-plugin-users": "^2.0.0-beta.10",
     "@nocobase/app-server": "^3.0.0-beta.3",
     "@nocobase/config": "^0.1.0-beta.3",
     "@nocobase/db": "^1.0.0-beta.22",
     "@nocobase/db-sqlite": "^0.1.0-beta.6",
     "@nocobase/service-provider": "^0.0.2-beta.2",
     "@nocobase/snowflake": "^1.0.0-beta.4",
-    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.15",
-    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.15",
-    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.14",
+    "@nocobase/app-plugin-authz-default-access": "^1.0.0-beta.16",
+    "@nocobase/app-plugin-authz-sharing-rules": "^1.0.0-beta.16",
+    "@nocobase/app-plugin-authz-restriction-rules": "^1.0.0-beta.15",
     "@nocobase/authorization": "^1.0.0-beta.15",
     "@nocobase/queue": "^0.1.0-beta.9",
     "@nocobase/jobs": "^0.1.0-beta.4",
     "@nocobase/lifecycle": "^0.1.0-beta.3",
     "@nocobase/i18n": "^2.0.0-beta.1",
-    "@nocobase/repository-input": "^0.1.0-beta.3",
     "@nocobase/caching": "^0.1.0-beta.3",
-    "@nocobase/app-cli": "^1.0.0-beta.27",
+    "@nocobase/repository-input": "^0.1.0-beta.3",
+    "@nocobase/app-cli": "^1.0.0-beta.28",
     "@nocobase/realtime": "^0.1.0-beta.3"
   },
   "description": "NocoBase 3 application template with the standard product capabilities.",
@@ -188,7 +189,7 @@
     "dev": "nocobase dev",
     "build": "nocobase build",
     "start": "nocobase start",
-    "check": "pnpm lint && pnpm format:check && pnpm typecheck && pnpm test && pnpm build",
+    "check": "pnpm check:packages && pnpm lint && pnpm format:check && pnpm typecheck && pnpm test && pnpm build",
     "fix": "pnpm lint:fix && pnpm format",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.node.json --noEmit && tsc -p tsconfig.server.json --noEmit",
     "lint": "eslint . --max-warnings 0",
@@ -198,6 +199,7 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "test:e2e": "playwright test --pass-with-no-tests"
+    "test:e2e": "playwright test --pass-with-no-tests",
+    "check:packages": "node scripts/check-packages.mjs"
   }
 }

package/scripts/check-packages.mjs

@@ -0,0 +1,46 @@
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+
+// Ask pnpm for exactly the packages the following check selects, respecting workspace exclusions.
+const root = path.resolve(import.meta.dirname, '..');
+const filter = './packages/**';
+const listed = spawnSync(
+  'pnpm',
+  ['--filter', filter, 'list', '--depth', '-1', '--json'],
+  {
+    cwd: root,
+    encoding: 'utf8',
+  },
+);
+if (listed.error) throw listed.error;
+if (listed.status !== 0) {
+  process.stderr.write(listed.stderr);
+  process.exit(listed.status ?? 1);
+}
+const packages = JSON.parse(listed.stdout || '[]');
+const missing = packages.filter(({ path: directory }) => {
+  const manifest = JSON.parse(
+    readFileSync(path.join(directory, 'package.json'), 'utf8'),
+  );
+  return (
+    typeof manifest.scripts?.check !== 'string' ||
+    !manifest.scripts.check.trim()
+  );
+});
+if (missing.length > 0) {
+  console.error(
+    'Every internal package must provide a non-empty check script:',
+  );
+  for (const entry of missing)
+    console.error(`  ${path.relative(root, entry.path)}`);
+  process.exit(1);
+}
+if (packages.length > 0) {
+  const result = spawnSync('pnpm', ['--filter', filter, 'check'], {
+    cwd: root,
+    stdio: 'inherit',
+  });
+  if (result.error) throw result.error;
+  process.exitCode = result.status ?? 1;
+}

package/tailwind.config.mjs

@@ -5,18 +5,12 @@
 // nothing, in this repository and in a generated application alike. Reading the directory first and resolving each
 // match to its real path gets past that, because `readdirSync` sees the symlinks and `realpathSync` resolves them.
 //
-// Client runtime files and canonical Registry source are both searched. A workspace plugin exposes TypeScript sources,
-// while an installed one may expose build output plus application-owned Registry recipes. Missing directories are skipped.
+// Scan plugin runtime source in a workspace and compiled output in installed packages. UI Library items installed
+// into the application are already covered by its own client source. Missing directories are skipped.
 import { existsSync, globSync, readdirSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 
-const SOURCE_DIRECTORIES = [
-  'client',
-  'dist/client',
-  'src',
-  'dist/src',
-  'registry',
-];
+const SOURCE_DIRECTORIES = ['client', 'dist/client', 'src', 'dist/src'];
 const SCANNED_FILES = '**/*.{js,jsx,ts,tsx}';
 
 /** Every scannable directory a workspace or installed `@nocobase` package exposes. */