@arronqzy/vue-view 0.1.23 → 0.1.24

package/README.md

@@ -49,9 +49,17 @@ import {
 } from "@arronqzy/vue-view";
 ```
 
-创建 / 同步发出 `workspace:add` / `workspace:sync`。`parseWorkspaceData` 的 `value` 可作 `initialWorkspace`。
+创建 / 同步发出 `workspace:add` / `workspace:sync`，删除工作区发出 `workspace:delete`（参数 `{ ids, nameSpace }`）。`parseWorkspaceData` 的 `value` 可作 `initialWorkspace`。
 
-本地保存的工作区可用 `listWorkspaceProjects` / `deleteWorkspaceProject` / `clearWorkspaceProjects`（参数为 `nameSpace`）列出和清理。其余 IndexedDB 读写与 `getPreviewSnapshot` **不导出**，缩略图只在 React 包实现。
+浏览器里的本地数据可以读取和清理，最后一个参数都是 `nameSpace`：
+
+- 工作区：`listWorkspaceProjects` / `getWorkspaceProject` / `deleteWorkspaceProject` / `clearWorkspaceProjects`
+- 蓝图库：`listBlueprintLibrary` / `getBlueprintLibraryRecord` / `deleteBlueprintLibraryRecord` / `clearBlueprintLibrary`
+- 蓝图执行日志：`listExecutionRunRecords` / `getExecutionRunRecord` / `deleteExecutionRunRecord` / `clearAllExecutionRunRecords` / `purgeExecutionRunsOlderThan` / `trimExecutionRunRecordsToMax`，保留策略用 `readExecutionLogSettings` / `writeExecutionLogSettings`
+- 接口集合：`listApiCollectionRecords` / `deleteApiCollection` / `clearApiCollections`
+- `clearAbuilderStorage`：一次清空以上四类，返回各自删除数量
+
+工作区、蓝图库的写入接口不导出（由编辑器自己维护）。`getPreviewSnapshot` 只在 React 包实现。
 
 ## 和 React 版的差别
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arronqzy/vue-view",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "description": "Vue 3 visual view editor for Abuilder (Ant Design Vue)",
   "license": "MIT",
   "type": "module",
@@ -24,12 +24,12 @@
     "uuid": "^13.0.0",
     "vue": "^3.5.13",
     "@arronqzy/i18n": "0.1.17",
-    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/rx-store": "1.0.8",
+    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/view-scene3d": "0.1.5",
     "@arronqzy/view-table": "0.1.8",
     "@arronqzy/vue-rx-store": "0.1.6",
-    "@arronqzy/vue-blueprint": "0.1.17"
+    "@arronqzy/vue-blueprint": "0.1.18"
   },
   "peerDependencies": {
     "vue": "^3.4.0"

package/src/index.ts

@@ -15,10 +15,37 @@ export {
 export { createWorkspaceProjectId } 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 {
   addEventSubscription,
   AbuilderEvents,
@@ -28,6 +55,7 @@ export type {
   AbuilderEventPayloadMap,
   WorkspaceAddEventPayload,
   WorkspaceSyncEventPayload,
+  WorkspaceDeleteEventPayload,
   ApiCollectionUploadStartEventPayload,
   ApiCollectionUploadSuccessEventPayload,
   WorkspaceData,

package/src/panel/VueViewPanel.vue

@@ -53,6 +53,7 @@ import {
 } from "./hooks/useWorkspaceProjects";
 import type { WorkspaceProjectRecord } from "./library/workspace-project-db";
 import { AbuilderEvents, emitAbuilderEvent } from "./library/event-subscription";
+import { subscribeBlueprintLibraryChanged } from "./library/blueprint-library-sync";
 import { type ViewportZoom } from "./viewportZoom";
 import PanelCanvas from "./components/PanelCanvas.vue";
 import ElementsLayer from "./components/ElementsLayer.vue";
@@ -424,6 +425,14 @@ onMounted(() => {
   void refreshBlueprintLibrary();
 });
 
+watch(
+  () => props.nameSpace,
+  (nameSpace, _prev, onCleanup) => {
+    onCleanup(subscribeBlueprintLibraryChanged(() => void refreshBlueprintLibrary(), nameSpace));
+  },
+  { immediate: true }
+);
+
 function handleWorkspaceProjectApplied(record: WorkspaceProjectRecord) {
   workspaceBlueprintRef.value = {
     document: record.blueprintDocument,

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

@@ -0,0 +1,70 @@
+import {
+  clearAllExecutionRunRecords,
+  clearApiCollections,
+  clearBlueprintLibrary as clearBlueprintLibraryRecords,
+  deleteBlueprintLibraryRecord as deleteBlueprintLibraryRecordRaw,
+} from "@arronqzy/vue-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/vue-blueprint";
+export type {
+  BlueprintLibraryListItem,
+  BlueprintLibraryRecord,
+  ExecutionRunRecord,
+  ExecutionLogSettings,
+} from "@arronqzy/vue-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;
 }