@nocobase/portal-template-default 1.0.8 → 1.0.10

package/registry/nocobase-i18n/extension.tsx

@@ -1,45 +0,0 @@
-import type { AppExtension } from "@/app/extension";
-import { LoadingState } from "@/components/app-shell/loading-state";
-import { Languages } from "lucide-react";
-import { lazy, Suspense } from "react";
-import { Route } from "react-router";
-import { LanguageUserMenuItems } from "./components";
-import "./locales";
-import { NocoBaseI18nBootstrap } from "./provider";
-
-const I18nDemoPage = lazy(() =>
-  import("./demo").then((module) => ({ default: module.I18nDemoPage }))
-);
-
-const nocobaseI18nExtension: AppExtension = {
-  id: "nocobase-i18n",
-  Provider: NocoBaseI18nBootstrap,
-  UserMenuItems: LanguageUserMenuItems,
-  resources: [
-    {
-      name: "i18n-demo",
-      list: "/i18n",
-      meta: {
-        label: "Internationalization",
-        i18nKey: "navigation.demo",
-        i18nOptions: { ns: "nocobase-i18n" },
-        icon: <Languages />,
-        description: "Optional frontend internationalization for the Starter.",
-        acl: { type: "authenticated" },
-      },
-    },
-  ],
-  routes: (
-    <Route
-      key="nocobase-i18n-demo"
-      path="/i18n"
-      element={
-        <Suspense fallback={<LoadingState className="min-h-80" />}>
-          <I18nDemoPage />
-        </Suspense>
-      }
-    />
-  ),
-};
-
-export default nocobaseI18nExtension;

package/registry/nocobase-i18n/index.ts

@@ -1,7 +0,0 @@
-export * from "./components";
-export * from "./provider";
-export * from "./server-resources";
-export {
-  registerLocaleResources,
-  useEnabledLocales,
-} from "@/providers/i18n";

package/registry/nocobase-i18n/locales/en-US.ts

@@ -1,39 +0,0 @@
-const enUS = {
-    "language.label": "Language",
-    "language.current": "Current language",
-    "language.switchError": "Unable to switch language.",
-    "navigation.group": "Localization",
-    "navigation.demo": "Internationalization",
-    "demo.title": "Internationalization",
-    "demo.description":
-      "Optional NocoBase server translations and language controls built on the Starter's internationalization runtime.",
-    "demo.switcher.title": "Language switcher",
-    "demo.switcher.description":
-      "The same reusable component is also integrated into the signed-in user menu.",
-    "demo.switcher.unavailable.title": "Only one language is enabled",
-    "demo.switcher.unavailable.description":
-      "Enable another language in NocoBase system settings to display the switcher.",
-    "demo.frontend.title": "Application UI translations",
-    "demo.frontend.description":
-      "The Starter provides the runtime while application and Registry components keep their messages in local resource files.",
-    "demo.frontend.actions": "Common actions",
-    "demo.server.title": "NocoBase metadata translations",
-    "demo.server.description":
-      "Collection and field labels are loaded from dynamic server namespaces such as lm-collections.",
-    "demo.currentLocale": "Current locale: {{locale}}",
-    "demo.prompt.title": "Prompt generator",
-    "demo.prompt.description":
-      "Describe a complete multilingual application scene and generate an implementation prompt.",
-    "demo.prompt.settings": "Scene settings",
-    "demo.prompt.scene": "Application scene",
-    "demo.prompt.languages": "Languages",
-    "demo.prompt.copy": "Copy prompt",
-    "demo.prompt.copied": "Copied",
-    "demo.prompt.copyError":
-      "Clipboard access failed. Select the prompt and copy it manually.",
-    "demo.prompt.output": "Generated prompt",
-    "demo.prompt.outputDescription":
-      "Updates as you change the scene and language requirements.",
-} as const;
-
-export default enUS;

package/registry/nocobase-i18n/locales/index.ts

@@ -1,8 +0,0 @@
-import { registerLocaleResources } from "@/providers/i18n";
-import enUS from "./en-US";
-import zhCN from "./zh-CN";
-
-registerLocaleResources("nocobase-i18n", {
-  "en-US": enUS,
-  "zh-CN": zhCN,
-});

package/registry/nocobase-i18n/locales/zh-CN.ts

@@ -1,35 +0,0 @@
-const zhCN = {
-    "language.label": "语言",
-    "language.current": "当前语言",
-    "language.switchError": "无法切换语言。",
-    "navigation.group": "本地化",
-    "navigation.demo": "国际化",
-    "demo.title": "国际化",
-    "demo.description":
-      "基于 Starter 国际化运行时的可选 NocoBase 服务端翻译与语言切换能力。",
-    "demo.switcher.title": "语言切换器",
-    "demo.switcher.description": "同一个可复用组件也会集成到登录用户菜单中。",
-    "demo.switcher.unavailable.title": "当前仅启用一种语言",
-    "demo.switcher.unavailable.description":
-      "请在 NocoBase 系统设置中启用其他语言，语言切换器才会显示。",
-    "demo.frontend.title": "应用 UI 文案翻译",
-    "demo.frontend.description":
-      "Starter 提供运行时，应用和 Registry 组件分别维护自己的本地语言资源。",
-    "demo.frontend.actions": "常用操作",
-    "demo.server.title": "NocoBase 元数据翻译",
-    "demo.server.description":
-      "数据表和字段名称从 lm-collections 等服务端动态 namespace 加载。",
-    "demo.currentLocale": "当前语言：{{locale}}",
-    "demo.prompt.title": "提示词生成器",
-    "demo.prompt.description": "描述完整的多语言应用场景并生成实现提示词。",
-    "demo.prompt.settings": "场景设置",
-    "demo.prompt.scene": "应用场景",
-    "demo.prompt.languages": "语言",
-    "demo.prompt.copy": "复制提示词",
-    "demo.prompt.copied": "已复制",
-    "demo.prompt.copyError": "无法访问剪贴板，请手动选中并复制提示词。",
-    "demo.prompt.output": "生成的提示词",
-    "demo.prompt.outputDescription": "修改场景和语言要求时会实时更新。",
-} as const;
-
-export default zhCN;

package/registry/nocobase-i18n/provider.tsx

@@ -1,44 +0,0 @@
-import { useEffect, useState, type PropsWithChildren } from "react";
-
-import { LoadingState } from "@/components/app-shell/loading-state";
-import { nocobaseClient } from "@/lib/nocobase/client";
-import { setLocalePersistence } from "@/providers/i18n";
-import { useSystemSettings } from "@/providers/system-settings";
-import { loadServerLocaleResources } from "./server-resources";
-
-export function NocoBaseI18nBootstrap({ children }: PropsWithChildren) {
-  const { settings } = useSystemSettings();
-  const [ready, setReady] = useState(false);
-
-  useEffect(
-    () =>
-      setLocalePersistence(async (locale) => {
-        if (!nocobaseClient.getToken()) return;
-        await nocobaseClient.action("users", "updateLang", {
-          method: "POST",
-          body: { appLang: locale },
-        });
-      }),
-    []
-  );
-
-  useEffect(() => {
-    let active = true;
-    void loadServerLocaleResources(settings)
-      .catch((error) => {
-        console.warn("Unable to load NocoBase locale resources", error);
-      })
-      .finally(() => {
-        if (active) setReady(true);
-      });
-    return () => {
-      active = false;
-    };
-  }, [settings]);
-
-  if (!ready) {
-    return <LoadingState className="min-h-80" />;
-  }
-
-  return children;
-}

package/registry/nocobase-i18n/server-resources.ts

@@ -1,166 +0,0 @@
-import { nocobaseClient } from "@/lib/nocobase/client";
-import {
-  type LocaleSystemSettings,
-  applyDocumentLocale,
-  getCurrentLocale,
-  i18n,
-  registerLocale,
-  setEnabledLocales,
-} from "@/providers/i18n";
-
-type ServerLanguagePayload = {
-  lang?: string;
-  resources?: Record<string, Record<string, string>>;
-};
-
-const serverResourceNamespaces = new Set(["lm-collections"]);
-const loadedServerResourceNamespaces = new Set<string>();
-const namespaceLoadPromises = new Map<string, Promise<void>>();
-let cachedServerResources: ServerLanguagePayload["resources"] = {};
-let serverResourcesPromise: Promise<void> | undefined;
-let bootstrapStarted = false;
-let bootstrapComplete = false;
-
-function mergeNamespace(namespace: string, locale?: string) {
-  const resource = cachedServerResources?.[namespace];
-  if (!locale || !resource) return false;
-  i18n.addResourceBundle(locale, namespace, resource, true, false);
-  loadedServerResourceNamespaces.add(namespace);
-  return true;
-}
-
-async function requestServerResources(
-  namespaces: string[],
-  requestedLocale?: string
-) {
-  const payload = await nocobaseClient.action<ServerLanguagePayload>(
-    "app",
-    "getLang",
-    {
-      method: "GET",
-      query: {
-        ...(requestedLocale ? { locale: requestedLocale } : {}),
-        ...(namespaces.length ? { ns: namespaces.join(",") } : {}),
-      },
-      includeRole: false,
-      withAclMeta: false,
-    }
-  );
-
-  cachedServerResources = {
-    ...cachedServerResources,
-    ...payload.resources,
-  };
-  for (const namespace of namespaces) {
-    mergeNamespace(namespace, payload.lang);
-    loadedServerResourceNamespaces.add(namespace);
-  }
-
-  return payload;
-}
-
-async function ensureServerResourceNamespaces(namespaces: string[]) {
-  const pending: Promise<void>[] = [];
-  const missing: string[] = [];
-
-  for (const namespace of namespaces) {
-    if (loadedServerResourceNamespaces.has(namespace)) continue;
-    if (mergeNamespace(namespace, getCurrentLocale())) continue;
-    const existing = namespaceLoadPromises.get(namespace);
-    if (existing) pending.push(existing);
-    else missing.push(namespace);
-  }
-
-  if (missing.length) {
-    const request = requestServerResources(
-      missing,
-      nocobaseClient.getStoredLocale() ?? getCurrentLocale()
-    ).then(() => undefined);
-    for (const namespace of missing) {
-      namespaceLoadPromises.set(namespace, request);
-    }
-    const cleanup = () => {
-      for (const namespace of missing) {
-        if (namespaceLoadPromises.get(namespace) === request) {
-          namespaceLoadPromises.delete(namespace);
-        }
-      }
-    };
-    void request.then(cleanup, cleanup);
-    pending.push(request);
-  }
-
-  await Promise.all(pending);
-}
-
-export function registerServerResourceNamespace(namespace: string) {
-  if (!namespace) return;
-  serverResourceNamespaces.add(namespace);
-
-  if (
-    mergeNamespace(namespace, getCurrentLocale()) ||
-    !bootstrapStarted ||
-    !bootstrapComplete
-  ) {
-    return;
-  }
-
-  void ensureServerResourceNamespaces([namespace]).catch((error) => {
-    console.warn(
-      `Unable to load NocoBase locale namespace ${namespace}`,
-      error
-    );
-  });
-}
-
-export function getServerResourceNamespaces() {
-  return [...serverResourceNamespaces];
-}
-
-export function loadServerLocaleResources(settings?: LocaleSystemSettings) {
-  if (serverResourcesPromise) return serverResourcesPromise;
-
-  bootstrapStarted = true;
-  const requestedLocale = nocobaseClient.getStoredLocale();
-  const initialNamespaces = [...serverResourceNamespaces];
-  const configuredLocales = Array.isArray(settings?.enabledLanguages)
-    ? settings.enabledLanguages
-    : [];
-  if (configuredLocales.length) setEnabledLocales(configuredLocales);
-  const languagePromise = requestServerResources(
-    initialNamespaces,
-    requestedLocale
-  );
-
-  serverResourcesPromise = languagePromise
-    .then(async (payload) => {
-      const serverLocale = payload.lang;
-
-      if (!configuredLocales.length && serverLocale) {
-        setEnabledLocales([serverLocale]);
-      }
-
-      if (serverLocale) {
-        registerLocale({ locale: serverLocale, label: serverLocale });
-        nocobaseClient.setLocale(serverLocale);
-        await i18n.changeLanguage(serverLocale);
-        applyDocumentLocale(serverLocale);
-      }
-
-      bootstrapComplete = true;
-      const lateNamespaces = [...serverResourceNamespaces].filter(
-        (namespace) => !loadedServerResourceNamespaces.has(namespace)
-      );
-      if (lateNamespaces.length) {
-        await ensureServerResourceNamespaces(lateNamespaces);
-      }
-    })
-    .catch((error) => {
-      bootstrapComplete = true;
-      if (!configuredLocales.length) setEnabledLocales([getCurrentLocale()]);
-      serverResourcesPromise = undefined;
-      throw error;
-    });
-
-  return serverResourcesPromise;
-}

package/registry/nocobase-i18n/tests/i18n-regression.mjs

@@ -1,51 +0,0 @@
-import assert from "node:assert/strict";
-import { createServer } from "vite";
-
-const server = await createServer({
-  appType: "custom",
-  logLevel: "silent",
-  server: { middlewareMode: true },
-});
-
-try {
-  await server.ssrLoadModule("/src/locales/index.ts");
-  const {
-    applySystemLocale,
-    getCurrentLocale,
-    i18n,
-    registerLocaleResources,
-    translate,
-  } = await server.ssrLoadModule("/src/providers/i18n/runtime.ts");
-  const { resolveTranslatableText } =
-    await server.ssrLoadModule("/src/lib/i18n.ts");
-
-  await i18n.changeLanguage("en-US");
-  assert.equal(translate("resources.users", { ns: "app" }, "Users"), "Users");
-
-  await i18n.changeLanguage("zh-CN");
-  assert.equal(translate("resources.users", { ns: "app" }, "Users"), "用户");
-  assert.equal(resolveTranslatableText('{{t("Admin")}}'), "管理员");
-  assert.equal(
-    resolveTranslatableText("Full permissions", { ns: "starter" }),
-    "全部权限"
-  );
-
-  registerLocaleResources("example-feature", {
-    "en-US": { title: "Example" },
-    "zh-CN": { title: "示例" },
-  });
-  assert.equal(
-    translate("title", { ns: "example-feature" }, "Example"),
-    "示例"
-  );
-
-  await applySystemLocale({
-    appLang: "en-US",
-    enabledLanguages: ["en-US", "zh-CN"],
-  });
-  assert.equal(getCurrentLocale(), "en-US");
-
-  console.log("NocoBase i18n regression tests passed");
-} finally {
-  await server.close();
-}