@arronqzy/react-view 1.0.36 → 1.0.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/react-view",
-  "version": "1.0.36",
+  "version": "1.0.38",
   "files": [
     "src",
     "dist",
@@ -33,11 +33,11 @@
     "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/ui": "1.0.10",
     "@arronqzy/i18n": "0.1.17",
-    "@arronqzy/react-blueprint": "1.0.22",
+    "@arronqzy/react-blueprint": "1.0.23",
     "@arronqzy/rx-store": "1.0.8",
     "@arronqzy/view-scene3d": "0.1.5",
-    "@arronqzy/view-table": "0.1.8",
-    "@arronqzy/webllm-assistant": "0.1.16"
+    "@arronqzy/webllm-assistant": "0.1.16",
+    "@arronqzy/view-table": "0.1.8"
   },
   "devDependencies": {
     "@types/react": "^19.0.1",
@@ -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

@@ -112,8 +112,9 @@ syncSub.unsubscribe();
 |------|------|----------|
 | `workspace:add` | `AbuilderEvents.workspaceAdd` | 创建成功 |
 | `workspace:sync` | `AbuilderEvents.workspaceSync` | 同步成功 |
+| `workspace:delete` | `AbuilderEvents.workspaceDelete` | 删除工作区，参数 `{ ids, nameSpace }` |
 
-字段：`id`、`name`、`createdAt`、`updatedAt`、`panelState`、`blueprintDocument`、`blueprintMeta`、`productName`、`titleIconDataUrl`。
+`workspace:add` / `workspace:sync` 的参数字段：`id`、`name`、`createdAt`、`updatedAt`、`panelState`、`blueprintDocument`、`blueprintMeta`、`productName`、`titleIconDataUrl`。
 
 校验：
 
@@ -154,6 +155,14 @@ const dataUrl = await getPreviewSnapshot({
 | `addEventSubscription` / `AbuilderEvents` | 工作区事件 |
 | `getPreviewSnapshot` | 预览截图 data URL |
 | `parseWorkspaceData` 等 | 校验 / 解析 / 空工作区 |
+| `listWorkspaceProjects` / `getWorkspaceProject` / `deleteWorkspaceProject` / `clearWorkspaceProjects` | 浏览器 IndexedDB 中保存的工作区 |
+| `listBlueprintLibrary` / `getBlueprintLibraryRecord` / `deleteBlueprintLibraryRecord` / `clearBlueprintLibrary` | 蓝图库；删除后已挂载的面板自动刷新 |
+| `listExecutionRunRecords` / `getExecutionRunRecord` / `deleteExecutionRunRecord` / `clearAllExecutionRunRecords` / `purgeExecutionRunsOlderThan` / `trimExecutionRunRecordsToMax` | 蓝图执行日志 |
+| `readExecutionLogSettings` / `writeExecutionLogSettings` | 执行日志保留策略 |
+| `listApiCollectionRecords` / `deleteApiCollection` / `clearApiCollections` | 接口集合 |
+| `clearAbuilderStorage` | 一次清空以上四类数据，返回各自删除数量；不动偏好设置 |
+
+本地数据函数的最后一个参数都是 `nameSpace`，要和面板的 `nameSpace` 一致。
 | `createView` / `createAction` | 视图 DSL 扩展点（`src/core`） |
 
 ## 样式

package/src/index.ts

@@ -14,10 +14,44 @@ export type {
   AbuilderEventPayloadMap,
   WorkspaceAddEventPayload,
   WorkspaceSyncEventPayload,
+  WorkspaceDeleteEventPayload,
   ApiCollectionUploadStartEventPayload,
   ApiCollectionUploadSuccessEventPayload,
   WorkspaceData,
 } from "./panel/library/event-subscription";
 export type { WorkspaceProjectRecord } from "./panel/library/workspace-project-db";
+export {
+  listWorkspaceProjects,
+  getWorkspaceProject,
+  deleteWorkspaceProject,
+  clearWorkspaceProjects,
+} from "./panel/library/workspace-storage";
+export type { WorkspaceProjectListItem } from "./panel/library/workspace-storage";
+export {
+  listBlueprintLibrary,
+  getBlueprintLibraryRecord,
+  deleteBlueprintLibraryRecord,
+  clearBlueprintLibrary,
+  listExecutionRunRecords,
+  getExecutionRunRecord,
+  deleteExecutionRunRecord,
+  clearAllExecutionRunRecords,
+  purgeExecutionRunsOlderThan,
+  trimExecutionRunRecordsToMax,
+  readExecutionLogSettings,
+  writeExecutionLogSettings,
+  listApiCollectionRecords,
+  deleteApiCollection,
+  clearApiCollections,
+  clearAbuilderStorage,
+} from "./panel/library/abuilder-storage";
+export type {
+  AbuilderStorageClearResult,
+  BlueprintLibraryListItem,
+  BlueprintLibraryRecord,
+  ExecutionRunRecord,
+  ExecutionLogSettings,
+  ApiCollectionRecord,
+} from "./panel/library/abuilder-storage";
 export { getPreviewSnapshot } from "./panel/library/preview-snapshot";
 export type { GetPreviewSnapshotOptions } from "./panel/library/preview-snapshot";

package/src/panel/ReactViewPanel.tsx

@@ -7,6 +7,7 @@ import type { PanelElement } from "./types";
 import { usePanelElements } from "./hooks/usePanelElements";
 import { useWorkspaceProjects } from "./hooks/useWorkspaceProjects";
 import type { WorkspaceProjectRecord } from "./library/workspace-project-db";
+import { subscribeBlueprintLibraryChanged } from "./library/blueprint-library-sync";
 import { WorkspaceProjectNav } from "./components/WorkspaceProjectNav";
 import { BusyOverlay } from "./components/BusyOverlay";
 import { PanelCanvas } from "./components/PanelCanvas";
@@ -803,6 +804,11 @@ function ReactViewPanelInner({
     void refreshBlueprintLibrary();
   }, [refreshBlueprintLibrary]);
 
+  useEffect(
+    () => subscribeBlueprintLibraryChanged(() => void refreshBlueprintLibrary(), nameSpace),
+    [nameSpace, refreshBlueprintLibrary]
+  );
+
   const loadBlueprintFromLibrary = useCallback(
     async (id: string) => {
       const record = await getBlueprintLibraryRecord(id, nameSpace);

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/abuilder-storage.ts

@@ -0,0 +1,70 @@
+import {
+  clearAllExecutionRunRecords,
+  clearApiCollections,
+  clearBlueprintLibrary as clearBlueprintLibraryRecords,
+  deleteBlueprintLibraryRecord as deleteBlueprintLibraryRecordRaw,
+} from "@arronqzy/react-blueprint";
+import { broadcastBlueprintLibraryChanged } from "./blueprint-library-sync";
+import { clearWorkspaceProjects } from "./workspace-storage";
+
+export {
+  listBlueprintLibrary,
+  getBlueprintLibraryRecord,
+  listExecutionRunRecords,
+  getExecutionRunRecord,
+  deleteExecutionRunRecord,
+  clearAllExecutionRunRecords,
+  purgeExecutionRunsOlderThan,
+  trimExecutionRunRecordsToMax,
+  readExecutionLogSettings,
+  writeExecutionLogSettings,
+  listApiCollectionRecords,
+  deleteApiCollection,
+  clearApiCollections,
+} from "@arronqzy/react-blueprint";
+export type {
+  BlueprintLibraryListItem,
+  BlueprintLibraryRecord,
+  ExecutionRunRecord,
+  ExecutionLogSettings,
+} from "@arronqzy/react-blueprint";
+export type { ApiCollectionRecord } from "@arronqzy/blueprint-dsl";
+
+/** 删除蓝图库中的一条蓝图；已挂载的编辑器会刷新蓝图库列表 */
+export async function deleteBlueprintLibraryRecord(
+  id: string,
+  nameSpace?: string | null
+): Promise<void> {
+  await deleteBlueprintLibraryRecordRaw(id, nameSpace);
+  broadcastBlueprintLibraryChanged(nameSpace);
+}
+
+/** 清空该 nameSpace 下的蓝图库，返回删除数量；已挂载的编辑器会刷新蓝图库列表 */
+export async function clearBlueprintLibrary(nameSpace?: string | null): Promise<number> {
+  const count = await clearBlueprintLibraryRecords(nameSpace);
+  broadcastBlueprintLibraryChanged(nameSpace);
+  return count;
+}
+
+export type AbuilderStorageClearResult = {
+  workspaces: number;
+  blueprints: number;
+  executionRuns: number;
+  apiCollections: number;
+};
+
+/**
+ * 清空该 nameSpace 下编辑器写入浏览器的全部数据：工作区、蓝图库、执行日志、接口集合。
+ * 主题、字号、日志保留设置等偏好不受影响。
+ */
+export async function clearAbuilderStorage(
+  nameSpace?: string | null
+): Promise<AbuilderStorageClearResult> {
+  const [workspaces, blueprints, executionRuns, apiCollections] = await Promise.all([
+    clearWorkspaceProjects(nameSpace),
+    clearBlueprintLibrary(nameSpace),
+    clearAllExecutionRunRecords(nameSpace),
+    clearApiCollections(nameSpace),
+  ]);
+  return { workspaces, blueprints, executionRuns, apiCollections };
+}

package/src/panel/library/blueprint-library-sync.ts

@@ -0,0 +1,22 @@
+import { appStorageKey } from "@arronqzy/blueprint-dsl";
+
+const CHANNEL = "arronqzy-blueprint-library-changed";
+
+export function broadcastBlueprintLibraryChanged(nameSpace?: string | null): void {
+  if (typeof BroadcastChannel === "undefined") return;
+  const channel = new BroadcastChannel(appStorageKey(CHANNEL, nameSpace));
+  channel.postMessage({ type: "changed" });
+  channel.close();
+}
+
+export function subscribeBlueprintLibraryChanged(
+  onChange: () => void,
+  nameSpace?: string | null
+): () => void {
+  if (typeof BroadcastChannel === "undefined") {
+    return () => {};
+  }
+  const channel = new BroadcastChannel(appStorageKey(CHANNEL, nameSpace));
+  channel.onmessage = () => onChange();
+  return () => channel.close();
+}

package/src/panel/library/event-subscription.ts

@@ -5,6 +5,8 @@ export const AbuilderEvents = {
   workspaceAdd: "workspace:add",
   /** 同步工作区 */
   workspaceSync: "workspace:sync",
+  /** 删除工作区（界面删除，或调用 deleteWorkspaceProject / clearWorkspaceProjects） */
+  workspaceDelete: "workspace:delete",
   /** 开始上传接口集合 */
   apiCollectionUploadStart: "api-collection:upload-start",
   /** 上传接口集合成功 */
@@ -18,6 +20,12 @@ export type WorkspaceData = WorkspaceProjectRecord;
 
 export type WorkspaceAddEventPayload = WorkspaceData;
 export type WorkspaceSyncEventPayload = WorkspaceData;
+export type WorkspaceDeleteEventPayload = {
+  /** 被删除的工作区 id */
+  ids: string[];
+  /** 所属 nameSpace，默认库为 null */
+  nameSpace: string | null;
+};
 
 export type ApiCollectionUploadStartEventPayload = {
   fileNames: string[];
@@ -36,6 +44,7 @@ export type ApiCollectionUploadSuccessEventPayload = {
 export type AbuilderEventPayloadMap = {
   [AbuilderEvents.workspaceAdd]: WorkspaceAddEventPayload;
   [AbuilderEvents.workspaceSync]: WorkspaceSyncEventPayload;
+  [AbuilderEvents.workspaceDelete]: WorkspaceDeleteEventPayload;
   [AbuilderEvents.apiCollectionUploadStart]: ApiCollectionUploadStartEventPayload;
   [AbuilderEvents.apiCollectionUploadSuccess]: ApiCollectionUploadSuccessEventPayload;
 };

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,51 @@
+import { normalizeAppNameSpace } from "@arronqzy/blueprint-dsl";
+import {
+  clearWorkspaceProjectStore,
+  deleteWorkspaceProject as deleteWorkspaceProjectRecord,
+  getWorkspaceProject,
+  listWorkspaceProjects,
+} from "./workspace-project-db";
+import {
+  clearWorkspacePreviewCaches,
+  removeWorkspacePreviewCache,
+} from "./workspace-project-cache";
+import { broadcastWorkspaceProjectsChanged } from "./workspace-project-sync";
+import { AbuilderEvents, emitAbuilderEvent } from "./event-subscription";
+
+export { listWorkspaceProjects, getWorkspaceProject };
+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);
+  emitAbuilderEvent(AbuilderEvents.workspaceDelete, {
+    ids: [id],
+    nameSpace: normalizeAppNameSpace(nameSpace) || null,
+  });
+}
+
+/**
+ * 清空该 `nameSpace` 下保存的全部工作区，返回删除的数量。
+ * 不影响蓝图库、执行日志、接口集合等其他存储。
+ */
+export async function clearWorkspaceProjects(nameSpace?: string | null): Promise<number> {
+  const items = await listWorkspaceProjects(nameSpace);
+  await clearWorkspaceProjectStore(nameSpace);
+  clearWorkspacePreviewCaches(nameSpace);
+  broadcastWorkspaceProjectsChanged({ type: "cleared" }, nameSpace);
+  if (items.length > 0) {
+    emitAbuilderEvent(AbuilderEvents.workspaceDelete, {
+      ids: items.map((item) => item.id),
+      nameSpace: normalizeAppNameSpace(nameSpace) || null,
+    });
+  }
+  return items.length;
+}