@pstdio/workbench 0.4.0 → 0.6.0

package/dist/storage.d.ts

@@ -1,5 +1,7 @@
 declare type ContributionSource = "module" | "extension";
 
+declare type ContributionSource_2 = "module" | "extension";
+
 export declare const createLocalStorageHistoryPersistence: (input: CreateWorkbenchStoragePersistenceInput) => WorkbenchHistoryPersistence;
 
 export declare const createLocalStorageLastResourcePersistence: (input: CreateLocalStorageLastResourcePersistenceInput) => LastResourcePersistenceAdapter;
@@ -25,10 +27,11 @@ export declare interface CreateLocalStorageTreePersistenceInput extends CreateWo
 export declare const createLocalStorageWorkbenchPersistence: (input: CreateLocalStorageWorkbenchPersistenceInput) => {
     snapshotPersistence: WorkbenchPersistenceAdapter;
     historyPersistence: WorkbenchHistoryPersistence;
-    layoutPersistence: LayoutPersistenceAdapter;
+    layoutPersistence: LayoutPersistenceAdapter_2;
     panelsPersistence: WorkbenchPanelsPersistenceAdapter;
     treePersistence: TreeRendererPersistenceAdapter;
     lastResourcePersistence: LastResourcePersistenceAdapter;
+    sidePanelPersistence: WorkbenchSidePanelPersistenceAdapter;
 };
 
 export declare interface CreateLocalStorageWorkbenchPersistenceInput extends CreateWorkbenchStoragePersistenceInput {
@@ -60,12 +63,31 @@ declare interface LastResourcePersistenceAdapter {
 declare interface LayoutPersistenceAdapter {
     getLayout(scope?: LayoutScope): WorkbenchLayout | undefined;
     setLayout(layout: WorkbenchLayout, scope?: LayoutScope): void;
+    listScopes?(projectId: string): LayoutScope[];
+    transformLayouts?(projectId: string, transform: (layout: WorkbenchLayout, scope: LayoutScope) => WorkbenchLayout | undefined): void;
+    getCompatibilityMarker?(key: string): string | undefined;
+    setCompatibilityMarker?(key: string, value: string): void;
+    advanceWriteGeneration?(): number;
+    flush?(): void;
+    dispose?(): void;
+}
+
+declare interface LayoutPersistenceAdapter_2 {
+    getLayout(scope?: LayoutScope_2): WorkbenchLayout_2 | undefined;
+    setLayout(layout: WorkbenchLayout_2, scope?: LayoutScope_2): void;
+    listScopes?(projectId: string): LayoutScope_2[];
+    transformLayouts?(projectId: string, transform: (layout: WorkbenchLayout_2, scope: LayoutScope_2) => WorkbenchLayout_2 | undefined): void;
+    getCompatibilityMarker?(key: string): string | undefined;
+    setCompatibilityMarker?(key: string, value: string): void;
+    advanceWriteGeneration?(): number;
     flush?(): void;
     dispose?(): void;
 }
 
 declare type LayoutScope = string;
 
+declare type LayoutScope_2 = string;
+
 declare interface PersistedTreeRendererStates {
     statesByTreeId: Record<string, TreeRendererState>;
 }
@@ -87,6 +109,15 @@ declare interface ResourceRef {
     metadata?: Record<string, unknown>;
 }
 
+declare interface ResourceRef_2 {
+    kind: string;
+    uri: string;
+    id?: string;
+    label?: string;
+    icon?: string;
+    metadata?: Record<string, unknown>;
+}
+
 declare interface TreeRendererPersistenceAdapter {
     getTreeStates(): PersistedTreeRendererStates | undefined;
     setTreeStates(states: PersistedTreeRendererStates): void;
@@ -101,6 +132,8 @@ declare interface TreeRendererState {
 
 declare type WidgetMountStrategy = "active" | "keep-mounted";
 
+declare type WidgetMountStrategy_2 = "active" | "keep-mounted";
+
 declare interface WorkbenchClosedSubPanel {
     region: WorkbenchPanelRegion;
     reference: WorkbenchSubPanelRef;
@@ -121,6 +154,14 @@ declare interface WorkbenchLayout {
     activeResourceUri?: string;
 }
 
+declare interface WorkbenchLayout_2 {
+    regions: Record<WorkbenchRegion_2, WorkbenchRegionState_2>;
+    locationSubPanelSelections?: Record<string, Partial<Record<WorkbenchPanelRegion_2, string>>>;
+    activeWidgetId?: string;
+    activeLocationWidgetId?: string;
+    activeResourceUri?: string;
+}
+
 declare interface WorkbenchLocationRef {
     key: string;
     modeId?: string;
@@ -146,8 +187,12 @@ declare interface WorkbenchNavigationEntry {
 
 declare type WorkbenchPanelRegion = (typeof workbenchPanelRegions)[number];
 
+declare type WorkbenchPanelRegion_2 = (typeof workbenchPanelRegions_2)[number];
+
 declare const workbenchPanelRegions: readonly ["main", "secondary", "side"];
 
+declare const workbenchPanelRegions_2: readonly ["main", "secondary", "side"];
+
 declare interface WorkbenchPanelsPersistenceAdapter {
     getPanelStates(scope?: string): PersistedWorkbenchPanels | undefined;
     setPanelStates(state: PersistedWorkbenchPanels, scope?: string): void;
@@ -162,8 +207,12 @@ declare interface WorkbenchPersistenceAdapter {
 
 declare type WorkbenchRegion = (typeof workbenchRegions)[number];
 
+declare type WorkbenchRegion_2 = (typeof workbenchRegions_2)[number];
+
 declare const workbenchRegions: readonly ["nav", "activity", "sidenav-header", "sidenav", "main-header", "main-left-menu", "main", "main-right-menu", "secondary-header", "secondary-left-menu", "secondary", "secondary-right-menu", "side-header", "side-left-menu", "side", "side-right-menu", "status", "overlay"];
 
+declare const workbenchRegions_2: readonly ["nav", "activity", "sidenav-header", "sidenav", "main-header", "main-left-menu", "main", "main-right-menu", "secondary-header", "secondary-left-menu", "secondary", "secondary-right-menu", "side-header", "side-left-menu", "side", "side-right-menu", "status", "overlay"];
+
 declare interface WorkbenchRegionState {
     id: WorkbenchRegion;
     visible: boolean;
@@ -172,19 +221,36 @@ declare interface WorkbenchRegionState {
     activeWidgetId?: string;
 }
 
+declare interface WorkbenchRegionState_2 {
+    id: WorkbenchRegion_2;
+    visible: boolean;
+    size?: number;
+    widgets: WorkbenchWidgetPlacement_2[];
+    activeWidgetId?: string;
+}
+
+declare type WorkbenchSidePanelMode = "floating" | "closed" | "attached";
+
+declare interface WorkbenchSidePanelPersistenceAdapter {
+    getMode(): WorkbenchSidePanelMode | undefined;
+    setMode(mode: WorkbenchSidePanelMode): void;
+}
+
 declare interface WorkbenchSnapshot {
     layout: WorkbenchLayout;
 }
 
 export declare interface WorkbenchStorageLike {
+    readonly length?: number;
     getItem(key: string): string | null;
+    key?(index: number): string | null;
     setItem(key: string, value: string): void;
     removeItem?(key: string): void;
 }
 
 export declare const workbenchStoragePersistenceKey: (namespace: string, kind: WorkbenchStoragePersistenceKind, scope: string | undefined) => string;
 
-export declare type WorkbenchStoragePersistenceKind = "history" | "layout" | "layout-resource-index" | "panels" | "tree" | "last-resource";
+export declare type WorkbenchStoragePersistenceKind = "history" | "layout" | "layout-compatibility" | "layout-generation" | "layout-resource-index" | "layout-scope-index" | "panels" | "side-panel" | "tree" | "last-resource";
 
 declare interface WorkbenchSubPanelRef {
     contributionId: string;
@@ -194,6 +260,8 @@ declare interface WorkbenchSubPanelRef {
 
 declare type WorkbenchTabRetention = "preview" | "persistent";
 
+declare type WorkbenchTabRetention_2 = "preview" | "persistent";
+
 declare interface WorkbenchWidgetPlacement {
     widgetId: string;
     contributionId: string;
@@ -212,12 +280,38 @@ declare interface WorkbenchWidgetPlacement {
     role?: WorkbenchWidgetRole;
 }
 
+declare interface WorkbenchWidgetPlacement_2 {
+    widgetId: string;
+    contributionId: string;
+    ownerId?: string;
+    source?: ContributionSource_2;
+    resource?: ResourceRef_2;
+    resourceUri?: string;
+    ownerResourceUri?: string;
+    title?: string;
+    pinned?: boolean;
+    closable?: boolean;
+    mountStrategy?: WidgetMountStrategy_2;
+    hiddenByDefault?: boolean;
+    tabRetention?: WorkbenchTabRetention_2;
+    tab?: WorkbenchWidgetTab_2;
+    role?: WorkbenchWidgetRole_2;
+}
+
 declare type WorkbenchWidgetRole = "content" | "location" | "sub-panel" | "panel-menu";
 
+declare type WorkbenchWidgetRole_2 = "content" | "location" | "sub-panel" | "panel-menu";
+
 declare interface WorkbenchWidgetTab {
     contentRendererId?: string;
     /** Custom actions shown when the user activates an already-active tab. */
     customMenuRendererId?: string;
 }
 
+declare interface WorkbenchWidgetTab_2 {
+    contentRendererId?: string;
+    /** Custom actions shown when the user activates an already-active tab. */
+    customMenuRendererId?: string;
+}
+
 export { }

package/dist/storage.js

@@ -1,182 +1,240 @@
-import { b as E } from "./layout-types-DMoZz38-.js";
-const S = 2, P = 1, b = 50, r = (e, s, t) => `${e}:${s}:${t ?? "global"}`, N = () => {
+const i = (e, t, n) => `${e}:${t}:${n ?? "global"}`, h = () => {
   const e = /* @__PURE__ */ new Map();
   return {
-    getItem: (s) => e.get(s) ?? null,
-    setItem: (s, t) => {
-      e.set(s, t);
+    get length() {
+      return e.size;
     },
-    removeItem: (s) => {
-      e.delete(s);
+    getItem: (t) => e.get(t) ?? null,
+    key: (t) => [...e.keys()][t] ?? null,
+    setItem: (t, n) => {
+      e.set(t, n);
+    },
+    removeItem: (t) => {
+      e.delete(t);
     }
   };
-}, d = (e) => e || (typeof localStorage < "u" ? localStorage : N()), p = (e, s) => {
-  const t = e.getItem(s);
-  if (t)
+}, d = (e) => e || (typeof localStorage < "u" ? localStorage : h()), y = (e, t) => {
+  const n = e.getItem(t);
+  if (n)
     try {
-      return JSON.parse(t);
+      return JSON.parse(n);
     } catch {
       return;
     }
-}, T = (e) => {
-  const s = d(e.storage), t = /* @__PURE__ */ new Map(), a = e.debounceMs ?? 250, m = e.eventTarget ?? (typeof window < "u" ? {
-    addEventListener: (n, o) => window.addEventListener(n, o),
-    removeEventListener: (n, o) => window.removeEventListener(n, o)
+};
+const T = (e) => {
+  const t = d(e.storage), n = /* @__PURE__ */ new Map(), c = e.debounceMs ?? 250, g = e.eventTarget ?? (typeof window < "u" ? {
+    addEventListener: (s, r) => window.addEventListener(s, r),
+    removeEventListener: (s, r) => window.removeEventListener(s, r)
   } : void 0);
   let l;
-  const R = (n) => n?.match(/^project\/([^/]+)\/mode\/[^/]+\/resource\//)?.[1], O = (n) => {
-    const o = R(n);
-    if (!o || !n) return;
-    const y = r(e.namespace, "layout-resource-index", o), c = p(s, y), i = typeof c == "object" && c !== null && "version" in c && c.version === P && "scopes" in c && Array.isArray(c.scopes) ? c.scopes.filter((g) => typeof g == "string" && g !== n && s.getItem(r(e.namespace, "layout", g)) !== null) : [];
-    i.push(n);
-    for (const g of i.splice(0, Math.max(0, i.length - b)))
-      s.removeItem?.(r(e.namespace, "layout", g)), s.removeItem?.(r(e.namespace, "panels", g));
-    const v = {
-      version: P,
-      scopes: i
+  const v = i(e.namespace, "layout-generation", void 0), S = () => {
+    const s = y(t, v);
+    return typeof s == "object" && s !== null && "version" in s && s.version === 1 && "generation" in s && typeof s.generation == "number" ? s.generation : 0;
+  }, O = () => {
+    const s = S() + 1, r = {
+      version: 1,
+      generation: s
     };
-    s.setItem(y, JSON.stringify(v));
-  }, f = () => {
+    return t.setItem(v, JSON.stringify(r)), s;
+  }, N = (s) => s?.match(/^project\/([^/]+)\/mode\/[^/]+\/resource\//)?.[1], I = (s) => s?.match(/^project\/([^/]+)/)?.[1], L = (s) => {
+    if (!t.key) return [];
+    const r = `${e.namespace}:layout:`, o = [];
+    for (let a = 0; a < (t.length ?? 0); a += 1) {
+      const m = t.key(a);
+      if (!m?.startsWith(r)) continue;
+      const u = m.slice(r.length);
+      I(u) === s && o.push(u);
+    }
+    return o;
+  }, f = (s, r) => {
+    const o = y(t, i(e.namespace, s, r));
+    return typeof o == "object" && o !== null && "version" in o && o.version === 1 && "scopes" in o && Array.isArray(o.scopes) ? o.scopes.filter((a) => typeof a == "string" && t.getItem(i(e.namespace, "layout", a)) !== null) : [];
+  }, E = (s, r, o) => {
+    const a = {
+      version: 1,
+      scopes: o
+    };
+    t.setItem(i(e.namespace, s, r), JSON.stringify(a));
+  }, R = (s) => {
+    const r = I(s);
+    if (!r || !s) return;
+    const o = f("layout-scope-index", r).filter((a) => a !== s);
+    o.push(s), E("layout-scope-index", r, o);
+  }, _ = (s) => {
+    const r = N(s);
+    if (!r || !s) return;
+    const o = f("layout-resource-index", r).filter((a) => a !== s);
+    o.push(s);
+    for (const a of o.splice(0, Math.max(0, o.length - 50)))
+      t.removeItem?.(i(e.namespace, "layout", a)), t.removeItem?.(i(e.namespace, "panels", a));
+    E("layout-resource-index", r, o);
+  }, p = () => {
     l && clearTimeout(l), l = void 0;
-    const n = [...t.values()];
-    t.clear();
-    for (const o of n)
-      s.setItem(r(e.namespace, "layout", o.scope), o.raw), O(o.scope), o.legacyPanelsKey && s.removeItem?.(o.legacyPanelsKey);
-  }, I = () => {
-    l && clearTimeout(l), l = setTimeout(f, a);
+    const s = [...n.values()];
+    n.clear();
+    const r = S();
+    for (const o of s)
+      o.generation === r && (t.setItem(i(e.namespace, "layout", o.scope), o.raw), R(o.scope), _(o.scope), o.legacyPanelsKey && t.removeItem?.(o.legacyPanelsKey));
+  }, P = () => {
+    l && clearTimeout(l), l = setTimeout(p, c);
   };
-  return m?.addEventListener("pagehide", f), {
-    getLayout: (n) => {
-      const o = r(e.namespace, "layout", n), y = t.has(o) ? JSON.parse(t.get(o).raw) : p(s, o);
-      if (y?.version === S) return y.layout;
-      if (y?.version !== 1) return;
-      const c = r(e.namespace, "panels", n), i = p(s, c), v = typeof i == "object" && i !== null && "openByRegionId" in i && typeof i.openByRegionId == "object" && i.openByRegionId !== null ? i.openByRegionId : {}, g = {
-        ...y.layout.regions
-      };
-      for (const u of E) {
-        const L = v[u];
-        typeof L == "boolean" && g[u] && (g[u] = {
-          ...g[u],
-          visible: L
-        });
+  return g?.addEventListener("pagehide", p), {
+    getLayout: (s) => {
+      const r = i(e.namespace, "layout", s), o = n.get(r), a = o && o.generation === S() ? JSON.parse(o.raw) : y(t, r);
+      if (a?.version === 3) return a.layout;
+    },
+    setLayout: (s, r) => {
+      const o = {
+        version: 3,
+        layout: s
+      }, a = i(e.namespace, "layout", r), m = i(e.namespace, "panels", r);
+      n.delete(a), n.set(a, {
+        generation: S(),
+        legacyPanelsKey: t.getItem(m) === null ? void 0 : m,
+        raw: JSON.stringify(o),
+        scope: r
+      }), P();
+    },
+    flush: p,
+    listScopes(s) {
+      return [.../* @__PURE__ */ new Set([...f("layout-scope-index", s), ...f("layout-resource-index", s), ...L(s)])];
+    },
+    transformLayouts(s, r) {
+      p(), O();
+      for (const o of this.listScopes?.(s) ?? []) {
+        const a = i(e.namespace, "layout", o), m = y(t, a);
+        if (m?.version !== 3) continue;
+        const u = r(m.layout, o);
+        if (!u) {
+          t.removeItem?.(a);
+          continue;
+        }
+        t.setItem(a, JSON.stringify({
+          version: 3,
+          layout: u
+        }));
       }
-      const h = {
-        ...y.layout,
-        regions: g
-      }, w = {
-        version: S,
-        layout: h
-      };
-      return t.set(o, {
-        legacyPanelsKey: s.getItem(c) === null ? void 0 : c,
-        raw: JSON.stringify(w),
-        scope: n
-      }), I(), h;
     },
-    setLayout: (n, o) => {
-      const y = {
-        version: S,
-        layout: n
-      }, c = r(e.namespace, "layout", o), i = r(e.namespace, "panels", o);
-      t.delete(c), t.set(c, {
-        legacyPanelsKey: s.getItem(i) === null ? void 0 : i,
-        raw: JSON.stringify(y),
-        scope: o
-      }), I();
+    getCompatibilityMarker: (s) => y(t, i(e.namespace, "layout-compatibility", s)),
+    setCompatibilityMarker: (s, r) => {
+      O(), t.setItem(i(e.namespace, "layout-compatibility", s), JSON.stringify(r));
     },
-    flush: f,
+    advanceWriteGeneration: O,
     dispose() {
-      f(), m?.removeEventListener("pagehide", f);
+      p(), g?.removeEventListener("pagehide", p);
     }
   };
 }, K = (e) => {
-  const s = d(e.storage);
+  const t = d(e.storage);
   return {
-    getHistory: (t) => p(s, r(e.namespace, "history", t)),
-    setHistory: (t, a) => {
-      s.setItem(r(e.namespace, "history", a), JSON.stringify(t));
+    getHistory: (n) => y(t, i(e.namespace, "history", n)),
+    setHistory: (n, c) => {
+      t.setItem(i(e.namespace, "history", c), JSON.stringify(n));
     }
   };
-}, J = (e) => {
-  const s = d(e.storage);
+}, k = (e) => {
+  const t = d(e.storage);
   return {
-    getPanelStates: (t) => p(s, r(e.namespace, "panels", t ?? e.scope)),
-    setPanelStates: (t, a) => {
-      const m = r(e.namespace, "panels", a ?? e.scope);
-      s.setItem(m, JSON.stringify(t));
+    getPanelStates: (n) => y(t, i(e.namespace, "panels", n ?? e.scope)),
+    setPanelStates: (n, c) => {
+      const g = i(e.namespace, "panels", c ?? e.scope);
+      t.setItem(g, JSON.stringify(n));
     }
   };
-}, k = (e) => {
-  const s = d(e.storage), t = r(e.namespace, "tree", e.scope);
+}, w = (e) => {
+  const t = d(e.storage), n = i(e.namespace, "tree", e.scope);
   return {
-    getTreeStates: () => p(s, t),
-    setTreeStates: (a) => {
-      s.setItem(t, JSON.stringify(a));
+    getTreeStates: () => y(t, n),
+    setTreeStates: (c) => {
+      t.setItem(n, JSON.stringify(c));
     }
   };
-}, B = (e) => !!e && typeof e.kind == "string" && typeof e.uri == "string", M = (e) => {
-  const s = d(e.storage), t = r(e.namespace, "last-resource", e.scope);
+}, C = (e) => !!e && typeof e.kind == "string" && typeof e.uri == "string", W = (e) => {
+  const t = d(e.storage), n = i(e.namespace, "last-resource", e.scope);
   return {
     getLastResource: () => {
-      const a = p(s, t);
-      return B(a) ? a : void 0;
+      const c = y(t, n);
+      return C(c) ? c : void 0;
     },
-    setLastResource: (a) => {
-      if (!a) {
-        s.removeItem?.(t);
+    setLastResource: (c) => {
+      if (!c) {
+        t.removeItem?.(n);
         return;
       }
-      s.setItem(t, JSON.stringify(a));
+      t.setItem(n, JSON.stringify(c));
+    }
+  };
+};
+const H = ["attached", "closed", "floating"], b = (e) => {
+  const t = d(e.storage), n = i(e.namespace, "side-panel", e.scope);
+  return {
+    getMode: () => {
+      const c = y(t, n);
+      if (c?.version === 1)
+        return H.includes(c.mode) ? c.mode : void 0;
+    },
+    setMode: (c) => {
+      const g = {
+        version: 1,
+        mode: c
+      };
+      t.setItem(n, JSON.stringify(g));
     }
   };
-}, j = (e) => {
-  const s = d(e.storage), t = T({
+}, A = (e) => {
+  const t = d(e.storage), n = T({
     debounceMs: e.debounceMs,
     eventTarget: e.eventTarget,
     namespace: e.namespace,
-    storage: s
+    storage: t
   });
   return {
     snapshotPersistence: {
-      getSnapshot: (m) => {
-        const l = t.getLayout(m);
+      getSnapshot: (g) => {
+        const l = n.getLayout(g);
         return l ? {
           layout: l
         } : void 0;
       },
-      setSnapshot: (m, l) => t.setLayout(m.layout, l),
-      flush: t.flush,
-      dispose: t.dispose
+      setSnapshot: (g, l) => n.setLayout(g.layout, l),
+      flush: n.flush,
+      dispose: n.dispose
     },
     historyPersistence: K({
       namespace: e.namespace,
-      storage: s
+      storage: t
     }),
-    layoutPersistence: t,
-    panelsPersistence: J({
+    layoutPersistence: n,
+    panelsPersistence: k({
       namespace: e.namespace,
       scope: e.scope ?? "global",
-      storage: s
+      storage: t
+    }),
+    treePersistence: w({
+      namespace: e.namespace,
+      scope: e.scope,
+      storage: t
     }),
-    treePersistence: k({
+    lastResourcePersistence: W({
       namespace: e.namespace,
       scope: e.scope,
-      storage: s
+      storage: t
     }),
-    lastResourcePersistence: M({
+    sidePanelPersistence: b({
       namespace: e.namespace,
       scope: e.scope,
-      storage: s
+      storage: t
     })
   };
 };
 export {
   K as createLocalStorageHistoryPersistence,
-  M as createLocalStorageLastResourcePersistence,
+  W as createLocalStorageLastResourcePersistence,
   T as createLocalStorageLayoutPersistence,
-  J as createLocalStoragePanelsPersistence,
-  k as createLocalStorageTreePersistence,
-  j as createLocalStorageWorkbenchPersistence,
-  r as workbenchStoragePersistenceKey
+  k as createLocalStoragePanelsPersistence,
+  w as createLocalStorageTreePersistence,
+  A as createLocalStorageWorkbenchPersistence,
+  i as workbenchStoragePersistenceKey
 };
 //# sourceMappingURL=storage.js.map