@floegence/floe-webapp-core 0.67.1 → 0.68.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;

package/dist/resource-cache.js

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

package/package.json

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