@arronqzy/vue-view 0.1.22 → 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`。
 
-IndexedDB CRUD 与 `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.22",
+  "version": "0.1.24",
   "description": "Vue 3 visual view editor for Abuilder (Ant Design Vue)",
   "license": "MIT",
   "type": "module",
@@ -23,13 +23,13 @@
     "selecto": "^1.26.3",
     "uuid": "^13.0.0",
     "vue": "^3.5.13",
-    "@arronqzy/blueprint-dsl": "1.0.17",
     "@arronqzy/i18n": "0.1.17",
-    "@arronqzy/view-table": "0.1.8",
     "@arronqzy/rx-store": "1.0.8",
-    "@arronqzy/vue-blueprint": "0.1.17",
+    "@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/view-scene3d": "0.1.5"
+    "@arronqzy/vue-blueprint": "0.1.18"
   },
   "peerDependencies": {
     "vue": "^3.4.0"

package/src/index.ts

@@ -13,6 +13,39 @@ export {
   createEmptyWorkspace,
 } from "./panel/library/parse-workspace-data";
 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,
@@ -22,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/hooks/useWorkspaceProjects.ts

@@ -9,14 +9,17 @@ import type { State } from "@arronqzy/rx-store";
 import { useI18nOptional } from "@arronqzy/i18n/vue";
 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,
@@ -140,6 +143,26 @@ export function useWorkspaceProjects(options: UseWorkspaceProjectsOptions) {
     }
   );
 
+  watch(
+    () => nameSpace(),
+    (ns, _prev, onCleanup) => {
+      const unsubscribe = subscribeWorkspaceProjectsChanged((message) => {
+        const active = activeProjectId.value;
+        const removedActive =
+          message.type === "cleared" ||
+          (active !== null && message.projectIds.includes(active));
+        if (removedActive) {
+          activeProjectId.value = null;
+          activeProjectName.value = null;
+          syncedSnapshotRef.value = null;
+        }
+        void refreshProjects();
+      }, ns);
+      onCleanup(unsubscribe);
+    },
+    { immediate: true }
+  );
+
   onUnmounted(() => {
     if (previewPollTimer !== undefined) window.clearInterval(previewPollTimer);
   });

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-project-cache.ts

@@ -35,3 +35,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

@@ -283,3 +283,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` 需与 `VueViewPanel` 的 `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;
+}