@arronqzy/react-view 1.0.37 → 1.0.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/react-view",
-  "version": "1.0.37",
+  "version": "1.0.38",
   "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.10",
     "@arronqzy/blueprint-dsl": "1.0.17",
+    "@arronqzy/ui": "1.0.10",
     "@arronqzy/i18n": "0.1.17",
+    "@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/react-blueprint": "1.0.22",
-    "@arronqzy/webllm-assistant": "0.1.16"
+    "@arronqzy/webllm-assistant": "0.1.16",
+    "@arronqzy/view-table": "0.1.8"
   },
   "devDependencies": {
     "@types/react": "^19.0.1",

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,7 +155,14 @@ const dataUrl = await getPreviewSnapshot({
 | `addEventSubscription` / `AbuilderEvents` | 工作区事件 |
 | `getPreviewSnapshot` | 预览截图 data URL |
 | `parseWorkspaceData` 等 | 校验 / 解析 / 空工作区 |
-| `listWorkspaceProjects` / `deleteWorkspaceProject` / `clearWorkspaceProjects` | 列出 / 删除 / 清空浏览器 IndexedDB 中保存的工作区（参数 `nameSpace`） |
+| `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,6 +14,7 @@ export type {
   AbuilderEventPayloadMap,
   WorkspaceAddEventPayload,
   WorkspaceSyncEventPayload,
+  WorkspaceDeleteEventPayload,
   ApiCollectionUploadStartEventPayload,
   ApiCollectionUploadSuccessEventPayload,
   WorkspaceData,
@@ -21,9 +22,36 @@ export type {
 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/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-storage.ts

@@ -1,6 +1,8 @@
+import { normalizeAppNameSpace } from "@arronqzy/blueprint-dsl";
 import {
   clearWorkspaceProjectStore,
   deleteWorkspaceProject as deleteWorkspaceProjectRecord,
+  getWorkspaceProject,
   listWorkspaceProjects,
 } from "./workspace-project-db";
 import {
@@ -8,8 +10,9 @@ import {
   removeWorkspacePreviewCache,
 } from "./workspace-project-cache";
 import { broadcastWorkspaceProjectsChanged } from "./workspace-project-sync";
+import { AbuilderEvents, emitAbuilderEvent } from "./event-subscription";
 
-export { listWorkspaceProjects };
+export { listWorkspaceProjects, getWorkspaceProject };
 export type { WorkspaceProjectListItem } from "./workspace-project-db";
 
 /**
@@ -23,6 +26,10 @@ export async function deleteWorkspaceProject(
   await deleteWorkspaceProjectRecord(id, nameSpace);
   removeWorkspacePreviewCache(id, nameSpace);
   broadcastWorkspaceProjectsChanged({ type: "deleted", projectIds: [id] }, nameSpace);
+  emitAbuilderEvent(AbuilderEvents.workspaceDelete, {
+    ids: [id],
+    nameSpace: normalizeAppNameSpace(nameSpace) || null,
+  });
 }
 
 /**
@@ -34,5 +41,11 @@ export async function clearWorkspaceProjects(nameSpace?: string | null): Promise
   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;
 }