@arronqzy/react-view 1.0.36 → 1.0.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/react-view",
-  "version": "1.0.36",
+  "version": "1.0.37",
   "files": [
     "src",
     "dist",
@@ -30,13 +30,13 @@
     "@codemirror/lang-json": "^6.0.1",
     "@codemirror/theme-one-dark": "^6.1.2",
     "@codemirror/view": "^6.36.2",
-    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/ui": "1.0.10",
+    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/i18n": "0.1.17",
-    "@arronqzy/react-blueprint": "1.0.22",
     "@arronqzy/rx-store": "1.0.8",
     "@arronqzy/view-scene3d": "0.1.5",
     "@arronqzy/view-table": "0.1.8",
+    "@arronqzy/react-blueprint": "1.0.22",
     "@arronqzy/webllm-assistant": "0.1.16"
   },
   "devDependencies": {
@@ -45,8 +45,8 @@
     "@types/use-sync-external-store": "^1.5.0",
     "eslint": "^8.57.0",
     "typescript": "^5.5.4",
-    "@arronqzy/typescript-config": "1.0.0",
     "@arronqzy/eslint-config": "0.0.0",
+    "@arronqzy/typescript-config": "1.0.0",
     "@arronqzy/tailwind": "1.0.2"
   },
   "scripts": {

package/readme.md

@@ -154,6 +154,7 @@ const dataUrl = await getPreviewSnapshot({
 | `addEventSubscription` / `AbuilderEvents` | 工作区事件 |
 | `getPreviewSnapshot` | 预览截图 data URL |
 | `parseWorkspaceData` 等 | 校验 / 解析 / 空工作区 |
+| `listWorkspaceProjects` / `deleteWorkspaceProject` / `clearWorkspaceProjects` | 列出 / 删除 / 清空浏览器 IndexedDB 中保存的工作区（参数 `nameSpace`） |
 | `createView` / `createAction` | 视图 DSL 扩展点（`src/core`） |
 
 ## 样式

package/src/index.ts

@@ -19,5 +19,11 @@ export type {
   WorkspaceData,
 } from "./panel/library/event-subscription";
 export type { WorkspaceProjectRecord } from "./panel/library/workspace-project-db";
+export {
+  listWorkspaceProjects,
+  deleteWorkspaceProject,
+  clearWorkspaceProjects,
+} from "./panel/library/workspace-storage";
+export type { WorkspaceProjectListItem } from "./panel/library/workspace-storage";
 export { getPreviewSnapshot } from "./panel/library/preview-snapshot";
 export type { GetPreviewSnapshotOptions } from "./panel/library/preview-snapshot";

package/src/panel/hooks/useWorkspaceProjects.ts

@@ -5,14 +5,17 @@ import type { BlueprintDocument, BlueprintMetaDraft } from "@arronqzy/react-blue
 import type { State } from "@arronqzy/rx-store";
 import {
   createWorkspaceProjectId,
-  deleteWorkspaceProject,
   getWorkspaceProject,
   listWorkspaceProjects,
   putWorkspaceProject,
   type WorkspaceProjectListItem,
   type WorkspaceProjectRecord,
 } from "../library/workspace-project-db";
-import { broadcastWorkspaceProjectUpdate } from "../library/workspace-project-sync";
+import { deleteWorkspaceProject } from "../library/workspace-storage";
+import {
+  broadcastWorkspaceProjectUpdate,
+  subscribeWorkspaceProjectsChanged,
+} from "../library/workspace-project-sync";
 import { writeWorkspacePreviewCache, readWorkspacePreviewCache } from "../library/workspace-project-cache";
 import {
   cloneWorkspaceSnapshot,
@@ -159,6 +162,20 @@ export function useWorkspaceProjects({
     void refreshProjects();
   }, [refreshProjects]);
 
+  useEffect(() => {
+    return subscribeWorkspaceProjectsChanged((message) => {
+      const removedActive =
+        message.type === "cleared" ||
+        (activeProjectId !== null && message.projectIds.includes(activeProjectId));
+      if (removedActive) {
+        setActiveProjectId(null);
+        setActiveProjectName(null);
+        syncedSnapshotRef.current = null;
+      }
+      void refreshProjects();
+    }, nameSpace);
+  }, [activeProjectId, nameSpace, refreshProjects]);
+
   useEffect(() => {
     if (!pendingRevisionSyncRef.current) return;
     syncedPanelRevisionRef.current = panelRevision;

package/src/panel/library/workspace-project-cache.ts

@@ -36,3 +36,30 @@ export function readWorkspacePreviewCache(
     return null;
   }
 }
+
+export function removeWorkspacePreviewCache(
+  projectId: string,
+  nameSpace?: string | null
+): void {
+  try {
+    localStorage.removeItem(previewCacheKey(projectId, nameSpace));
+  } catch {
+    // ignore private mode
+  }
+}
+
+export function clearWorkspacePreviewCaches(nameSpace?: string | null): void {
+  try {
+    const suffix = appStorageKey("", nameSpace);
+    const keys: string[] = [];
+    for (let i = 0; i < localStorage.length; i += 1) {
+      const key = localStorage.key(i);
+      if (!key || !key.startsWith(CACHE_PREFIX)) continue;
+      // 无 nameSpace 时 key 不带 "__<ns>" 后缀，避免误删其他 nameSpace 的标记
+      if (suffix ? key.endsWith(suffix) : !key.includes("__")) keys.push(key);
+    }
+    keys.forEach((key) => localStorage.removeItem(key));
+  } catch {
+    // ignore private mode
+  }
+}

package/src/panel/library/workspace-project-db.ts

@@ -286,3 +286,7 @@ export async function deleteWorkspaceProject(
 ): Promise<void> {
   await runTransaction<undefined>("readwrite", (store) => store.delete(id), nameSpace);
 }
+
+export async function clearWorkspaceProjectStore(nameSpace?: string | null): Promise<void> {
+  await runTransaction<undefined>("readwrite", (store) => store.clear(), nameSpace);
+}

package/src/panel/library/workspace-project-sync.ts

@@ -1,6 +1,7 @@
 import { appStorageKey } from "@arronqzy/blueprint-dsl";
 
 const CHANNEL_PREFIX = "arronqzy-workspace-project";
+const LIST_CHANNEL = "arronqzy-workspace-projects-changed";
 
 export type WorkspaceProjectSyncMessage = {
   type: "updated";
@@ -8,6 +9,36 @@ export type WorkspaceProjectSyncMessage = {
   updatedAt: number;
 };
 
+export type WorkspaceProjectsChangedMessage =
+  | { type: "deleted"; projectIds: string[] }
+  | { type: "cleared" };
+
+export function broadcastWorkspaceProjectsChanged(
+  message: WorkspaceProjectsChangedMessage,
+  nameSpace?: string | null
+): void {
+  if (typeof BroadcastChannel === "undefined") return;
+  const channel = new BroadcastChannel(appStorageKey(LIST_CHANNEL, nameSpace));
+  channel.postMessage(message);
+  channel.close();
+}
+
+export function subscribeWorkspaceProjectsChanged(
+  onChange: (message: WorkspaceProjectsChangedMessage) => void,
+  nameSpace?: string | null
+): () => void {
+  if (typeof BroadcastChannel === "undefined") {
+    return () => {};
+  }
+  const channel = new BroadcastChannel(appStorageKey(LIST_CHANNEL, nameSpace));
+  channel.onmessage = (event: MessageEvent<WorkspaceProjectsChangedMessage>) => {
+    const data = event.data;
+    if (!data || (data.type !== "deleted" && data.type !== "cleared")) return;
+    onChange(data);
+  };
+  return () => channel.close();
+}
+
 export function getWorkspaceProjectChannelName(
   projectId: string,
   nameSpace?: string | null

package/src/panel/library/workspace-storage.ts

@@ -0,0 +1,38 @@
+import {
+  clearWorkspaceProjectStore,
+  deleteWorkspaceProject as deleteWorkspaceProjectRecord,
+  listWorkspaceProjects,
+} from "./workspace-project-db";
+import {
+  clearWorkspacePreviewCaches,
+  removeWorkspacePreviewCache,
+} from "./workspace-project-cache";
+import { broadcastWorkspaceProjectsChanged } from "./workspace-project-sync";
+
+export { listWorkspaceProjects };
+export type { WorkspaceProjectListItem } from "./workspace-project-db";
+
+/**
+ * 删除 IndexedDB 中保存的单个工作区（及其 localStorage 预览标记）。
+ * `nameSpace` 需与 `ReactViewPanel` 的 `nameSpace` 一致；已挂载的面板会自动刷新工作区列表。
+ */
+export async function deleteWorkspaceProject(
+  id: string,
+  nameSpace?: string | null
+): Promise<void> {
+  await deleteWorkspaceProjectRecord(id, nameSpace);
+  removeWorkspacePreviewCache(id, nameSpace);
+  broadcastWorkspaceProjectsChanged({ type: "deleted", projectIds: [id] }, nameSpace);
+}
+
+/**
+ * 清空该 `nameSpace` 下保存的全部工作区，返回删除的数量。
+ * 不影响蓝图库、执行日志、接口集合等其他存储。
+ */
+export async function clearWorkspaceProjects(nameSpace?: string | null): Promise<number> {
+  const items = await listWorkspaceProjects(nameSpace);
+  await clearWorkspaceProjectStore(nameSpace);
+  clearWorkspacePreviewCaches(nameSpace);
+  broadcastWorkspaceProjectsChanged({ type: "cleared" }, nameSpace);
+  return items.length;
+}