@floegence/floe-webapp-core 0.67.1 → 0.69.0

package/dist/context/FloeConfigContext.d.ts

@@ -59,6 +59,8 @@ export interface FloeLayoutConfig {
             max: number;
         };
         defaultActiveTab: string;
+        /** Disable when the consumer owns navigation persistence. Defaults to true. */
+        persistActiveTab?: boolean;
         defaultCollapsed: boolean;
     };
     terminal: {

package/dist/context/LayoutContext.js

@@ -5,16 +5,16 @@ import { useResolvedFloeConfig as v } from "./FloeConfigContext.js";
 const {
   Provider: x,
   use: C,
-  useOptional: L
+  useOptional: A
 } = u({
   name: "Layout",
   init: g
 });
 function g() {
-  const d = v(), i = () => d.config.layout, p = () => typeof window > "u" ? !1 : window.matchMedia(i().mobileQuery).matches, s = d.persist.load(i().storageKey, {}), h = {
+  const n = v(), i = () => n.config.layout, p = () => typeof window > "u" ? !1 : window.matchMedia(i().mobileQuery).matches, s = n.persist.load(i().storageKey, {}), h = {
     sidebar: {
       width: s.sidebar?.width ?? i().sidebar.defaultWidth,
-      activeTab: s.sidebar?.activeTab ?? i().sidebar.defaultActiveTab,
+      activeTab: (i().sidebar.persistActiveTab !== !1 ? s.sidebar?.activeTab : void 0) ?? i().sidebar.defaultActiveTab,
       collapsed: s.sidebar?.collapsed ?? i().sidebar.defaultCollapsed
     },
     terminal: {
@@ -22,44 +22,46 @@ function g() {
       height: s.terminal?.height ?? i().terminal.defaultHeight
     },
     isMobile: p()
-  }, [t, o] = c(h), [l, b] = c({
+  }, [a, o] = c(h), [l, b] = c({
     motion: "animated",
     revision: 0
   }), m = (e) => Math.max(i().sidebar.clamp.min, Math.min(i().sidebar.clamp.max, e));
   return f(() => {
     const e = {
       sidebar: {
-        width: t.sidebar.width,
-        activeTab: t.sidebar.activeTab,
-        collapsed: t.sidebar.collapsed
+        width: a.sidebar.width,
+        ...i().sidebar.persistActiveTab !== !1 ? {
+          activeTab: a.sidebar.activeTab
+        } : {},
+        collapsed: a.sidebar.collapsed
       },
       terminal: {
-        opened: t.terminal.opened,
-        height: t.terminal.height
+        opened: a.terminal.opened,
+        height: a.terminal.height
       }
     };
-    d.persist.debouncedSave(i().storageKey, e);
+    n.persist.debouncedSave(i().storageKey, e);
   }), {
     // Sidebar accessors
-    sidebarWidth: () => t.sidebar.width,
-    sidebarActiveTab: () => t.sidebar.activeTab,
-    sidebarCollapsed: () => t.sidebar.collapsed,
+    sidebarWidth: () => a.sidebar.width,
+    sidebarActiveTab: () => a.sidebar.activeTab,
+    sidebarCollapsed: () => a.sidebar.collapsed,
     sidebarVisibilityMotion: () => l.motion,
     sidebarVisibilityMotionRevision: () => l.revision,
     clampSidebarWidth: m,
     // Sidebar actions
-    setSidebarWidth: (e) => o(r((a) => {
-      a.sidebar.width = m(e);
+    setSidebarWidth: (e) => o(r((t) => {
+      t.sidebar.width = m(e);
     })),
-    setSidebarActiveTab: (e, a) => {
-      o(r((n) => {
-        n.sidebar.activeTab = e, a?.openSidebar !== !1 && (n.sidebar.collapsed = !1);
-      })), a?.visibilityMotion === "instant" && b(r((n) => {
-        n.motion = "instant", n.revision += 1;
+    setSidebarActiveTab: (e, t) => {
+      o(r((d) => {
+        d.sidebar.activeTab = e, t?.openSidebar !== !1 && (d.sidebar.collapsed = !1);
+      })), t?.visibilityMotion === "instant" && b(r((d) => {
+        d.motion = "instant", d.revision += 1;
       }));
     },
-    setSidebarCollapsed: (e) => o(r((a) => {
-      a.sidebar.collapsed = e;
+    setSidebarCollapsed: (e) => o(r((t) => {
+      t.sidebar.collapsed = e;
     })),
     toggleSidebarCollapse: () => o(r((e) => {
       e.sidebar.collapsed = !e.sidebar.collapsed;
@@ -68,17 +70,17 @@ function g() {
       l.revision === e && b("motion", "animated");
     },
     // Terminal accessors
-    terminalOpened: () => t.terminal.opened,
-    terminalHeight: () => t.terminal.height,
+    terminalOpened: () => a.terminal.opened,
+    terminalHeight: () => a.terminal.height,
     // Terminal actions
     toggleTerminal: () => o(r((e) => {
       e.terminal.opened = !e.terminal.opened;
     })),
-    setTerminalHeight: (e) => o(r((a) => {
-      a.terminal.height = Math.max(i().terminal.clamp.min, Math.min(i().terminal.clamp.max, e));
+    setTerminalHeight: (e) => o(r((t) => {
+      t.terminal.height = Math.max(i().terminal.clamp.min, Math.min(i().terminal.clamp.max, e));
     })),
     // Mobile
-    isMobile: () => t.isMobile,
+    isMobile: () => a.isMobile,
     setIsMobile: (e) => o("isMobile", e)
   };
 }
@@ -86,5 +88,5 @@ export {
   x as LayoutProvider,
   g as createLayoutService,
   C as useLayout,
-  L as useOptionalLayout
+  A as useOptionalLayout
 };

package/dist/resource-cache.d.ts

@@ -12,6 +12,8 @@ export interface ResourceCacheStorage {
 }
 export interface ResourceSnapshot<T> {
     readonly data: T | undefined;
+    /** True until storage settles, or live data/invalidation supersedes restoration. */
+    readonly restoring: boolean;
     readonly refreshing: boolean;
     readonly stale: boolean;
     readonly error: unknown;
@@ -36,6 +38,8 @@ export interface CachedResourceDefinition<T> {
 }
 export interface ResourceCache {
     resource<T>(definition: CachedResourceDefinition<T>): CachedResource<T>;
+    /** Abort pending refreshes without retiring snapshots, storage, hydration or subscribers. */
+    cancelRefreshes(scope: string): void;
     clearScope(scope: string): Promise<void>;
     flush(): Promise<void>;
     dispose(): void;

package/dist/resource-cache.js

@@ -1,175 +1,186 @@
-async function N(f, i) {
-  const g = [...await f.list()].sort((e, t) => e.lastAccessedAt - t.lastAccessedAt);
-  let d = g.reduce((e, t) => e + t.bytes, 0);
-  const o = [];
-  for (const e of g) {
-    if (d <= Math.max(0, i)) break;
-    await f.remove(e.key), o.push(e.key), d -= e.bytes;
+async function J(y, l) {
+  const m = [...await y.list()].sort((r, s) => r.lastAccessedAt - s.lastAccessedAt);
+  let i = m.reduce((r, s) => r + s.bytes, 0);
+  const a = [];
+  for (const r of m) {
+    if (i <= Math.max(0, l)) break;
+    await y.remove(r.key), a.push(r.key), i -= r.bytes;
   }
-  return o;
+  return a;
 }
-function I(f) {
-  const i = f.storage, g = Math.max(0, f.maxBytes ?? 32 * 1024 * 1024), d = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
-  let e, t = Promise.resolve(), a = !1;
-  const l = (s) => (t = t.then(s).catch(() => {
-  }), t), v = async () => {
-    const s = await N({
-      list: async () => (await i.list()).map((r) => ({ ...r, lastAccessedAt: Math.max(r.lastAccessedAt, d.get(r.key)?.accessedAt ?? 0) })),
-      remove: (r) => i.remove(r)
-    }, g);
-    for (const r of s) d.get(r)?.evicted();
-  }, y = async () => {
-    clearTimeout(e), e = void 0;
-    const s = [...o];
-    o.clear(), s.length && l(async () => {
-      for (const [r, h] of s)
-        if (h.valid())
+function z(y) {
+  const l = y.storage, m = Math.max(0, y.maxBytes ?? 32 * 1024 * 1024), i = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map();
+  let r, s = Promise.resolve(), n = !1;
+  const d = (t) => (s = s.then(t).catch(() => {
+  }), s), f = async () => {
+    const t = await J({
+      list: async () => (await l.list()).map((e) => ({ ...e, lastAccessedAt: Math.max(e.lastAccessedAt, i.get(e.key)?.accessedAt ?? 0) })),
+      remove: (e) => l.remove(e)
+    }, m);
+    for (const e of t) i.get(e)?.evicted();
+  }, p = async () => {
+    clearTimeout(r), r = void 0;
+    const t = [...a];
+    a.clear(), t.length && d(async () => {
+      for (const [e, v] of t)
+        if (v.valid())
           try {
-            await i.set(r, h.value), h.stored();
+            await l.set(e, v.value), v.stored();
           } catch {
           }
-      await v();
-    }), await t;
-  }, k = (s, r, h, c) => {
-    o.set(s, { value: r, valid: h, stored: c }), e === void 0 && (e = setTimeout(() => {
-      y();
-    }, f.writeDelayMs ?? 100));
+      await f();
+    }), await s;
+  }, x = (t, e, v, o) => {
+    a.set(t, { value: e, valid: v, stored: o }), r === void 0 && (r = setTimeout(() => {
+      p();
+    }, y.writeDelayMs ?? 100));
   };
   return {
-    resource: (s) => {
-      if (a) throw new Error("Resource cache is disposed");
-      if (!s.scope || !s.key || !Number.isSafeInteger(s.version)) throw new Error("Invalid resource identity");
-      const r = JSON.stringify([s.scope, s.key, s.version]), h = d.get(r);
-      if (h)
-        return h.accessedAt = Date.now(), h.handle;
-      let c = { data: void 0, refreshing: !1, stale: !0, error: void 0 };
-      const D = /* @__PURE__ */ new Set();
-      let R = 0, p = 0, q, x, b, w;
-      const m = () => {
-        for (const n of D) n();
-      }, E = (n) => {
-        ++R, c = { data: n, refreshing: c.refreshing, stale: !1, error: void 0 };
+    resource: (t) => {
+      if (n) throw new Error("Resource cache is disposed");
+      if (!t.scope || !t.key || !Number.isSafeInteger(t.version)) throw new Error("Invalid resource identity");
+      const e = JSON.stringify([t.scope, t.key, t.version]), v = i.get(e);
+      if (v)
+        return v.accessedAt = Date.now(), v.handle;
+      let o = { data: void 0, restoring: !0, refreshing: !1, stale: !0, error: void 0 };
+      const S = /* @__PURE__ */ new Set();
+      let D = 0, w = 0, E, R, g, h, M;
+      const b = () => {
+        for (const c of S) c();
+      }, P = (c) => {
+        ++D, o = { data: c, restoring: !1, refreshing: o.refreshing, stale: !1, error: void 0 };
         try {
-          const u = JSON.stringify({ version: s.version, data: s.persist ? s.persist(n) : n });
-          q = u, u !== x ? k(r, u, () => q === u, () => {
-            x = u;
-          }) : o.delete(r);
+          const u = JSON.stringify({ version: t.version, data: t.persist ? t.persist(c) : c });
+          E = u, u !== R ? x(e, u, () => E === u, () => {
+            R = u;
+          }) : a.delete(e);
         } catch {
         }
-        m();
-      }, B = R, C = i.get(r).then((n) => {
-        if (!(a || R !== B || n === null))
+        b();
+      }, C = D, O = l.get(e).then((c) => {
+        if (!(n || D !== C || c === null))
           try {
-            const u = JSON.parse(n);
-            if (u.version !== s.version) throw new Error("Unsupported snapshot");
-            const A = s.decode(u.data);
-            c = { ...c, data: A, stale: !0 }, q = n, x = n, m();
+            const u = JSON.parse(c);
+            if (u.version !== t.version) throw new Error("Unsupported snapshot");
+            const A = t.decode(u.data);
+            o = { ...o, data: A, stale: !0 }, E = c, R = c;
           } catch {
-            l(() => i.remove(r));
+            d(() => l.remove(e));
           }
       }).catch(() => {
-      }), M = {
-        snapshot: () => c,
-        subscribe: (n) => (D.add(n), () => {
-          D.delete(n);
+      }).finally(() => {
+        n || !o.restoring || (o = { ...o, restoring: !1 }, b());
+      }), q = {
+        snapshot: () => o,
+        subscribe: (c) => (S.add(c), () => {
+          S.delete(c);
         }),
-        hydrate: () => C,
-        refresh: (n) => {
-          if (w) return w;
-          const u = ++p, A = new AbortController();
-          return b = A, c = { ...c, refreshing: !0, error: void 0 }, m(), w = Promise.resolve().then(() => n(A.signal)).then((S) => (!a && u === p && !A.signal.aborted && E(S), S), (S) => {
-            throw !a && u === p && !A.signal.aborted && (c = { ...c, stale: !0, error: S }, m()), S;
-          }).finally(() => {
-            u === p && (w = void 0, b = void 0, c = { ...c, refreshing: !1 }, m());
-          }), w;
+        hydrate: () => O,
+        refresh: (c) => {
+          if (h) return h;
+          const u = ++w, A = new AbortController();
+          g = A, o = { ...o, refreshing: !0, error: void 0 }, b();
+          const B = new Promise((k, I) => {
+            M = () => I(new DOMException("Resource refresh cancelled", "AbortError"));
+          }), N = Promise.resolve().then(() => c(A.signal)).then((k) => (!n && u === w && !A.signal.aborted && P(k), k), (k) => {
+            throw !n && u === w && !A.signal.aborted && (o = { ...o, stale: !0, error: k }, b()), k;
+          });
+          return h = Promise.race([N, B]).finally(() => {
+            u === w && (h = void 0, g = void 0, M = void 0, o = { ...o, refreshing: !1 }, b());
+          }), h;
         },
-        set: (n) => {
-          ++p, b?.abort(), w = void 0, c = { ...c, refreshing: !1 }, E(n);
+        set: (c) => {
+          ++w, g?.abort(), h = void 0, o = { ...o, refreshing: !1 }, P(c);
         },
-        invalidate: (n = !1) => {
-          ++R, ++p, b?.abort(), b = void 0, w = void 0, q = void 0, x = void 0, o.delete(r), c = { data: n ? void 0 : c.data, refreshing: !1, stale: !0, error: void 0 }, m(), l(() => i.remove(r));
+        invalidate: (c = !1) => {
+          ++D, ++w, g?.abort(), g = void 0, h = void 0, E = void 0, R = void 0, a.delete(e), o = { data: c ? void 0 : o.data, restoring: !1, refreshing: !1, stale: !0, error: void 0 }, b(), d(() => l.remove(e));
         }
       };
-      return d.set(r, { scope: s.scope, accessedAt: Date.now(), evicted: () => {
-        x = void 0;
-      }, handle: M, stop: () => {
-        ++p, b?.abort(), D.clear();
-      } }), M;
+      return i.set(e, { scope: t.scope, accessedAt: Date.now(), evicted: () => {
+        R = void 0;
+      }, handle: q, cancelRefresh: () => {
+        h && (++w, M?.(), M = void 0, g?.abort(), g = void 0, h = void 0, o = { ...o, refreshing: !1, stale: !0 }, b());
+      }, stop: () => {
+        ++w, g?.abort(), S.clear();
+      } }), q;
     },
-    flush: y,
-    clearScope: async (s) => {
-      for (const r of d.values()) r.scope === s && r.handle.invalidate(!0);
-      await l(async () => {
-        for (const r of await i.list())
+    flush: p,
+    cancelRefreshes: (t) => {
+      for (const e of i.values()) e.scope === t && e.cancelRefresh();
+    },
+    clearScope: async (t) => {
+      for (const e of i.values()) e.scope === t && e.handle.invalidate(!0);
+      await d(async () => {
+        for (const e of await l.list())
           try {
-            JSON.parse(r.key)[0] === s && await i.remove(r.key);
+            JSON.parse(e.key)[0] === t && await l.remove(e.key);
           } catch {
           }
       });
     },
     dispose: () => {
-      if (!a) {
-        a = !0;
-        for (const s of d.values()) s.stop();
-        y(), d.clear();
+      if (!n) {
+        n = !0;
+        for (const t of i.values()) t.stop();
+        p(), i.clear();
       }
     }
   };
 }
-function J(f = "floe-resource-cache") {
-  let i;
-  const g = () => i ??= new Promise((o, e) => {
-    const t = indexedDB.open(f, 1);
-    t.onupgradeneeded = () => t.result.createObjectStore("snapshots", { keyPath: "key" }), t.onsuccess = () => {
-      const a = t.result;
-      a.onversionchange = () => {
-        a.close(), i = void 0;
-      }, o(a);
-    }, t.onerror = () => {
-      i = void 0, e(t.error);
-    }, t.onblocked = () => {
-      i = void 0, e(new Error("Resource cache database is blocked"));
+function L(y = "floe-resource-cache") {
+  let l;
+  const m = () => l ??= new Promise((a, r) => {
+    const s = indexedDB.open(y, 1);
+    s.onupgradeneeded = () => s.result.createObjectStore("snapshots", { keyPath: "key" }), s.onsuccess = () => {
+      const n = s.result;
+      n.onversionchange = () => {
+        n.close(), l = void 0;
+      }, a(n);
+    }, s.onerror = () => {
+      l = void 0, r(s.error);
+    }, s.onblocked = () => {
+      l = void 0, r(new Error("Resource cache database is blocked"));
     };
-  }), d = async (o, e) => {
-    const t = await g();
-    return new Promise((a, l) => {
-      const v = t.transaction("snapshots", o);
-      let y;
-      v.oncomplete = () => a(y), v.onerror = () => l(v.error), v.onabort = () => l(v.error ?? new Error("Resource cache transaction aborted")), e(v.objectStore("snapshots"), (k) => {
-        y = k;
+  }), i = async (a, r) => {
+    const s = await m();
+    return new Promise((n, d) => {
+      const f = s.transaction("snapshots", a);
+      let p;
+      f.oncomplete = () => n(p), f.onerror = () => d(f.error), f.onabort = () => d(f.error ?? new Error("Resource cache transaction aborted")), r(f.objectStore("snapshots"), (x) => {
+        p = x;
       });
     });
   };
   return {
-    get: (o) => d("readwrite", (e, t) => {
-      const a = e.get(o);
-      a.onsuccess = () => {
-        const l = a.result;
-        l && e.put({ ...l, lastAccessedAt: Date.now() }), t(l?.value ?? null);
+    get: (a) => i("readwrite", (r, s) => {
+      const n = r.get(a);
+      n.onsuccess = () => {
+        const d = n.result;
+        d && r.put({ ...d, lastAccessedAt: Date.now() }), s(d?.value ?? null);
       };
     }),
-    set: (o, e) => d("readwrite", (t, a) => {
-      t.put({ key: o, value: e, bytes: new TextEncoder().encode(e).byteLength, lastAccessedAt: Date.now() }), a(void 0);
+    set: (a, r) => i("readwrite", (s, n) => {
+      s.put({ key: a, value: r, bytes: new TextEncoder().encode(r).byteLength, lastAccessedAt: Date.now() }), n(void 0);
     }),
-    remove: (o) => d("readwrite", (e, t) => {
-      e.delete(o), t(void 0);
+    remove: (a) => i("readwrite", (r, s) => {
+      r.delete(a), s(void 0);
     }),
-    list: () => d("readonly", (o, e) => {
-      const t = [], a = o.openCursor();
-      a.onsuccess = () => {
-        const l = a.result;
-        if (!l) {
-          e(t);
+    list: () => i("readonly", (a, r) => {
+      const s = [], n = a.openCursor();
+      n.onsuccess = () => {
+        const d = n.result;
+        if (!d) {
+          r(s);
           return;
         }
-        const { key: v, bytes: y, lastAccessedAt: k } = l.value;
-        t.push({ key: v, bytes: y, lastAccessedAt: k }), l.continue();
+        const { key: f, bytes: p, lastAccessedAt: x } = d.value;
+        s.push({ key: f, bytes: p, lastAccessedAt: x }), d.continue();
       };
     })
   };
 }
 export {
-  J as createIndexedDBResourceCacheStorage,
-  I as createResourceCache,
-  N as enforceResourceCacheBudget
+  L as createIndexedDBResourceCacheStorage,
+  z as createResourceCache,
+  J as enforceResourceCacheBudget
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floegence/floe-webapp-core",
-  "version": "0.67.1",
+  "version": "0.69.0",
   "license": "MIT",
   "type": "module",
   "main": "./dist/index.js",