@arronqzy/react-view 1.0.21 → 1.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/react-view",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "files": [
     "src",
     "dist",
@@ -30,14 +30,14 @@
     "@codemirror/lang-json": "^6.0.1",
     "@codemirror/theme-one-dark": "^6.1.2",
     "@codemirror/view": "^6.36.2",
-    "@arronqzy/ui": "1.0.6",
-    "@arronqzy/blueprint-dsl": "1.0.10",
-    "@arronqzy/i18n": "0.1.8",
-    "@arronqzy/react-blueprint": "1.0.12",
-    "@arronqzy/rx-store": "1.0.5",
-    "@arronqzy/webllm-assistant": "0.1.10",
-    "@arronqzy/view-table": "0.1.5",
-    "@arronqzy/view-scene3d": "0.1.2"
+    "@arronqzy/ui": "1.0.7",
+    "@arronqzy/blueprint-dsl": "1.0.12",
+    "@arronqzy/react-blueprint": "1.0.14",
+    "@arronqzy/view-table": "0.1.6",
+    "@arronqzy/view-scene3d": "0.1.3",
+    "@arronqzy/i18n": "0.1.9",
+    "@arronqzy/webllm-assistant": "0.1.11",
+    "@arronqzy/rx-store": "1.0.6"
   },
   "devDependencies": {
     "@types/react": "^19.0.1",
@@ -46,8 +46,8 @@
     "eslint": "^8.57.0",
     "typescript": "^5.5.4",
     "@arronqzy/eslint-config": "0.0.0",
-    "@arronqzy/typescript-config": "1.0.0",
-    "@arronqzy/tailwind": "1.0.2"
+    "@arronqzy/tailwind": "1.0.2",
+    "@arronqzy/typescript-config": "1.0.0"
   },
   "scripts": {
     "lint": "eslint \"src/**/*.{ts,tsx}\"",

package/readme.md

@@ -147,7 +147,12 @@ const dataUrl = await getPreviewSnapshot({
 | `parseOnlinePreviewSearchParams` | 解析预览 URL 参数 |
 | `addEventSubscription` | 订阅工作区事件，返回 `{ unsubscribe }` |
 | `AbuilderEvents` | 工作区事件名常量 |
-| `getPreviewSnapshot` | 获取预览画面 base64 缩略图 |
+| `getPreviewSnapshot` | 获取预览画面 base64 缩略图（仅本包 / `@arronqzy/abuilder`） |
+| `parseWorkspaceData` / `validateWorkspaceData` | 解析或校验完整工作区；`parse` 的 `value` 可作 `initialWorkspace` |
+| `parseViewData` / `validateViewData` | 解析或校验视图 `panelState` |
+| `parseBlueprintData` / `validateBlueprintData` | 解析或校验蓝图文档 |
+| `createEmptyWorkspace` | 构造空工作区记录 |
+| `createWorkspaceProjectId` | 生成工作区 ID |
 | `WorkspaceData` / `WorkspaceProjectRecord` | 完整工作区数据类型 |
 | `createView` / `createAction` 等 | 视图 DSL 与指令扩展（`src/core`） |
 

package/src/panel/I18nRoot.tsx

@@ -1,4 +1,6 @@
 import { I18nProvider } from "@arronqzy/i18n/react";
+import { LOCALE_STORAGE_KEY } from "@arronqzy/i18n";
+import { appStorageKey } from "@arronqzy/blueprint-dsl";
 import type { Locale } from "@arronqzy/i18n";
 import type { ReactNode } from "react";
 
@@ -6,12 +8,22 @@ export type I18nRootProps = {
   children: ReactNode;
   locale?: Locale | null;
   onLocaleChange?: (locale: Locale) => void;
+  nameSpace?: string | null;
 };
 
 /** Ensures panel / preview subtree always has i18n context (host apps, duplicate package graphs). */
-export function I18nRoot({ children, locale, onLocaleChange }: I18nRootProps) {
+export function I18nRoot({
+  children,
+  locale,
+  onLocaleChange,
+  nameSpace,
+}: I18nRootProps) {
   return (
-    <I18nProvider locale={locale} onLocaleChange={onLocaleChange}>
+    <I18nProvider
+      locale={locale}
+      onLocaleChange={onLocaleChange}
+      storageKey={appStorageKey(LOCALE_STORAGE_KEY, nameSpace)}
+    >
       {children}
     </I18nProvider>
   );

package/src/panel/ReactViewOnlinePreview.tsx

@@ -54,6 +54,7 @@ export type ReactViewOnlinePreviewProps = {
   workspace?: WorkspaceProjectRecord | null;
   locale?: Locale | null;
   onLocaleChange?: (locale: Locale) => void;
+  nameSpace?: string | null;
 };
 
 function applyTitleIcon(titleIconDataUrl?: string) {
@@ -68,20 +69,24 @@ function applyTitleIcon(titleIconDataUrl?: string) {
   }
 }
 
-async function loadWorkspaceRecord(projectId: string): Promise<WorkspaceProjectRecord | null> {
-  const fromDb = await getWorkspaceProject(projectId);
+async function loadWorkspaceRecord(
+  projectId: string,
+  nameSpace?: string | null
+): Promise<WorkspaceProjectRecord | null> {
+  const fromDb = await getWorkspaceProject(projectId, nameSpace);
   if (fromDb) return fromDb;
-  return readWorkspacePreviewCache(projectId);
+  return readWorkspacePreviewCache(projectId, nameSpace);
 }
 
 export function ReactViewOnlinePreview({
   locale,
   onLocaleChange,
+  nameSpace,
   ...rest
 }: ReactViewOnlinePreviewProps) {
   return (
-    <I18nRoot locale={locale} onLocaleChange={onLocaleChange}>
-      <ReactViewOnlinePreviewInner {...rest} />
+    <I18nRoot locale={locale} onLocaleChange={onLocaleChange} nameSpace={nameSpace}>
+      <ReactViewOnlinePreviewInner nameSpace={nameSpace} {...rest} />
     </I18nRoot>
   );
 }
@@ -90,6 +95,7 @@ function ReactViewOnlinePreviewInner({
   projectId,
   previewInstanceId,
   workspace = null,
+  nameSpace = null,
 }: ReactViewOnlinePreviewProps) {
   const { t } = useI18n();
 
@@ -102,7 +108,7 @@ function ReactViewOnlinePreviewInner({
   >([]);
   const [layoutRevision, setLayoutRevision] = useState(0);
   const [layoutReady, setLayoutReady] = useState(false);
-  const [outputScale, setOutputScale] = useState(() => readOutputScale());
+  const [outputScale, setOutputScale] = useState(() => readOutputScale(nameSpace));
   const [fillScale, setFillScale] = useState({ scaleX: 1, scaleY: 1 });
 
   const sceneRef = useRef<HTMLDivElement | null>(null);
@@ -122,7 +128,9 @@ function ReactViewOnlinePreviewInner({
       setPanelState(normalized);
       setBlueprintGraph(BlueprintGraph.fromDocument(record.blueprintDocument));
       document.title =
-        record.productName.trim() || record.name || t("panel.workspace.previewDocTitle");
+        (typeof record.productName === "string" ? record.productName : "").trim() ||
+        record.name ||
+        t("panel.workspace.previewDocTitle");
       applyTitleIcon(record.titleIconDataUrl);
       setProjectRevision((v) => v + 1);
       return true;
@@ -141,7 +149,7 @@ function ReactViewOnlinePreviewInner({
       return;
     }
 
-    const record = await loadWorkspaceRecord(projectId);
+    const record = await loadWorkspaceRecord(projectId, nameSpace);
     if (!record) {
       setLoadError(t("panel.messages.workspaceNotFound"));
       setPanelState(null);
@@ -149,7 +157,7 @@ function ReactViewOnlinePreviewInner({
     }
 
     applyWorkspaceRecord(record);
-  }, [applyWorkspaceRecord, projectId, t, workspace]);
+  }, [applyWorkspaceRecord, nameSpace, projectId, t, workspace]);
 
   useEffect(() => {
     void loadProject();
@@ -159,8 +167,8 @@ function ReactViewOnlinePreviewInner({
     if (workspace || !projectId) return;
     return subscribeWorkspaceProjectUpdates(projectId, () => {
       void loadProject();
-    });
-  }, [loadProject, projectId, workspace]);
+    }, nameSpace);
+  }, [loadProject, nameSpace, projectId, workspace]);
 
   const layers = useMemo(
     () => (panelState ? parsePanelLayers(panelState) : []),
@@ -177,13 +185,13 @@ function ReactViewOnlinePreviewInner({
 
   useEffect(() => {
     let cancelled = false;
-    void listBlueprintLibrary().then((items) => {
+    void listBlueprintLibrary(nameSpace).then((items) => {
       if (!cancelled) setBlueprintLibraryItems(items);
     });
     return () => {
       cancelled = true;
     };
-  }, [projectRevision]);
+  }, [nameSpace, projectRevision]);
 
   const blueprintLibraryNameById = useMemo(
     () => new Map(blueprintLibraryItems.map((item) => [item.id, item.name])),
@@ -192,13 +200,13 @@ function ReactViewOnlinePreviewInner({
 
   const resolveLibraryBlueprint = useCallback<LibraryBlueprintResolver>(
     async (libraryBlueprintId) => {
-      const record = await getBlueprintLibraryRecord(libraryBlueprintId);
+      const record = await getBlueprintLibraryRecord(libraryBlueprintId, nameSpace);
       if (!record) return null;
-      const items = await listBlueprintLibrary();
+      const items = await listBlueprintLibrary(nameSpace);
       const nameById = new Map(items.map((item) => [item.id, item.name]));
       return documentToRunnableGraph(record.document, { libraryNameById: nameById });
     },
-    []
+    [nameSpace]
   );
 
   const handleViewScopeUpdate = useCallback(
@@ -251,7 +259,7 @@ function ReactViewOnlinePreviewInner({
   );
 
   const applySceneFit = useCallback(() => {
-    const enabled = readOutputScale();
+    const enabled = readOutputScale(nameSpace);
     setOutputScale(enabled);
     const fill = applyPreviewSceneFill(
       sceneRef.current,
@@ -262,7 +270,7 @@ function ReactViewOnlinePreviewInner({
     setFillScale({ scaleX: fill.scaleX, scaleY: fill.scaleY });
     setLayoutRevision((v) => v + 1);
     notifyPreviewLayoutChanged();
-  }, [sceneBounds.height, sceneBounds.width]);
+  }, [nameSpace, sceneBounds.height, sceneBounds.width]);
 
   useLayoutEffect(() => {
     if (!panelState || layerElements.length === 0) return;
@@ -451,13 +459,16 @@ function ReactViewOnlinePreviewInner({
 export function parseOnlinePreviewSearchParams(search: string): {
   projectId: string;
   previewInstanceId?: string;
+  nameSpace?: string;
 } | null {
   const params = new URLSearchParams(search);
   if (params.get("preview") !== "online") return null;
   const projectId = params.get("projectId") ?? params.get("id");
   if (!projectId) return null;
+  const nameSpace = (params.get("ns") ?? params.get("nameSpace") ?? "").trim();
   return {
     projectId,
     previewInstanceId: params.get("pid") ?? undefined,
+    nameSpace: nameSpace || undefined,
   };
 }