@floegence/floe-webapp-core 0.26.5 → 0.26.6

package/dist/app/ActivityAppsMain.js

@@ -1,36 +1,30 @@
-import { createComponent as n, Dynamic as a } from "solid-js/web";
+import { createComponent as i, Dynamic as u } from "solid-js/web";
 import { untrack as d, createMemo as m } from "solid-js";
 import { useLayout as l } from "../context/LayoutContext.js";
-import { useComponentRegistry as v } from "../context/ComponentRegistry.js";
+import { useOptionalComponentRegistry as v } from "../context/ComponentRegistry.js";
 import { KeepAliveStack as f } from "../components/layout/KeepAliveStack.js";
-function y(e) {
+function w(e) {
   return e.sidebar?.fullScreen === !0 || e.sidebar?.renderIn === "main";
 }
-function A(e) {
-  const i = l(), r = (() => {
-    try {
-      return v();
-    } catch {
-      return null;
-    }
-  })();
+function b(e) {
+  const n = l(), r = v();
   if (!d(() => !!e.views) && !r)
     throw new Error("ActivityAppsMain requires ComponentRegistryProvider when `views` is not provided.");
-  const o = () => e.activeId ? e.activeId() : i.sidebarActiveTab(), u = m(() => {
+  const o = () => e.activeId ? e.activeId() : n.sidebarActiveTab(), s = m(() => {
     if (!r) return [];
-    const s = e.include ?? y;
-    return r.sidebarItems().filter((t) => s(t)).map((t) => ({
+    const c = e.include ?? w;
+    return r.sidebarItems().filter((t) => c(t)).map((t) => ({
       id: t.id,
-      render: () => n(a, {
+      render: () => i(u, {
         get component() {
           return t.component;
         }
       })
     }));
-  }), c = () => e.views ?? u();
-  return n(f, {
+  }), a = () => e.views ?? s();
+  return i(f, {
     get views() {
-      return c();
+      return a();
     },
     get activeId() {
       return o();
@@ -47,5 +41,5 @@ function A(e) {
   });
 }
 export {
-  A as ActivityAppsMain
+  b as ActivityAppsMain
 };

package/dist/context/ComponentRegistry.d.ts

@@ -98,4 +98,6 @@ export declare const ComponentRegistryProvider: (props: {
     children: import("solid-js").JSX.Element;
 }) => import("solid-js").JSX.Element;
 export declare function useComponentRegistry<TProtocol = unknown>(): ComponentRegistryValue<TProtocol>;
+export declare function useOptionalComponentRegistry<TProtocol = unknown>(): ComponentRegistryValue<TProtocol> | undefined;
+export declare function hasComponentRegistryContext(): boolean;
 export declare function createComponentRegistry(): ComponentRegistryValue<unknown>;

package/dist/context/ComponentRegistry.js

@@ -1,12 +1,12 @@
-import { createSignal as y } from "solid-js";
+import { createSignal as C } from "solid-js";
 import { createSimpleContext as h } from "./createSimpleContext.js";
 import { useResolvedFloeConfig as w } from "./FloeConfigContext.js";
-import { useTheme as v } from "./ThemeContext.js";
-import { useLayout as x } from "./LayoutContext.js";
+import { useTheme as x } from "./ThemeContext.js";
+import { useLayout as v } from "./LayoutContext.js";
 import { useCommand as b } from "./CommandContext.js";
-import { useNotification as M } from "./NotificationContext.js";
-import { deferNonBlocking as S } from "../utils/defer.js";
-function A(r) {
+import { useNotification as R } from "./NotificationContext.js";
+import { deferNonBlocking as M } from "../utils/defer.js";
+function S(r) {
   const s = `[${r}]`;
   return {
     debug: (...n) => console.debug(s, ...n),
@@ -15,47 +15,53 @@ function A(r) {
     error: (...n) => console.error(s, ...n)
   };
 }
-function R(r, s) {
+function A(r, s) {
   const n = `component:${s}:`;
   return {
     get: (a, m) => r.load(n + a, m),
     set: (a, m) => r.debouncedSave(n + a, m),
-    remove: (a) => S(() => r.remove(n + a))
+    remove: (a) => M(() => r.remove(n + a))
   };
 }
-function G() {
-  const r = v(), s = x(), n = b(), a = M(), m = w();
-  return (f, l) => ({
-    protocol: l?.protocol,
+function D() {
+  const r = x(), s = v(), n = b(), a = R(), m = w();
+  return (f, p) => ({
+    protocol: p?.protocol,
     theme: r,
     layout: s,
     commands: n,
     notifications: a,
-    storage: R(m.persist, f),
-    logger: A(f)
+    storage: A(m.persist, f),
+    logger: S(f)
   });
 }
-const C = h({
+const l = h({
   name: "ComponentRegistry",
   init: B
-}), H = C.Provider;
+}), G = l.Provider;
+function H() {
+  return l.use();
+}
 function J() {
-  return C.use();
+  return l.useOptional();
+}
+function K() {
+  return l.has();
 }
 function B() {
-  const [r, s] = y(/* @__PURE__ */ new Map()), [n, a] = y(/* @__PURE__ */ new Set()), m = /* @__PURE__ */ new Map(), f = (t) => {
+  const [r, s] = C(/* @__PURE__ */ new Map()), [n, a] = C(/* @__PURE__ */ new Set()), m = /* @__PURE__ */ new Map(), f = (t) => {
     s((e) => new Map(e).set(t.id, t));
-  }, l = (t) => {
+  }, p = (t) => {
     const e = t.map((o) => o.id).filter((o) => !!o);
     return s((o) => {
       const c = new Map(o);
       return t.forEach((u) => c.set(u.id, u)), c;
     }), () => {
       e.forEach((o) => {
-        g(o);
+        y(o);
       });
     };
-  }, d = async (t, e) => {
+  }, g = async (t, e) => {
     const o = r().get(t);
     if (!o || n().has(t)) return;
     const c = [];
@@ -79,7 +85,7 @@ function B() {
     } catch (u) {
       throw c.forEach((i) => i()), u;
     }
-  }, p = async (t) => {
+  }, d = async (t) => {
     const e = r().get(t);
     if (e && n().has(t))
       try {
@@ -90,25 +96,25 @@ function B() {
           return c.delete(t), c;
         });
       }
-  }, g = async (t) => {
-    await p(t), s((e) => {
+  }, y = async (t) => {
+    await d(t), s((e) => {
       const o = new Map(e);
       return o.delete(t), o;
     });
   };
   return {
     register: f,
-    registerAll: l,
-    unregister: g,
-    mount: d,
-    unmount: p,
+    registerAll: p,
+    unregister: y,
+    mount: g,
+    unmount: d,
     mountAll: async (t) => {
       for (const e of r().keys())
-        await d(e, t(e));
+        await g(e, t(e));
     },
     unmountAll: async () => {
       for (const t of n())
-        await p(t);
+        await d(t);
     },
     components: r,
     mountedComponents: n,
@@ -137,8 +143,10 @@ function B() {
   };
 }
 export {
-  H as ComponentRegistryProvider,
+  G as ComponentRegistryProvider,
   B as createComponentRegistry,
-  G as useComponentContextFactory,
-  J as useComponentRegistry
+  K as hasComponentRegistryContext,
+  D as useComponentContextFactory,
+  H as useComponentRegistry,
+  J as useOptionalComponentRegistry
 };

package/dist/context/FloeConfigContext.d.ts

@@ -156,6 +156,8 @@ export interface PersistApi {
      * while keeping debounced persistence in the hot interaction path.
      */
     flush?: () => void;
+    /** Cleanup pending timers (best-effort). */
+    dispose?: () => void;
 }
 export interface FloeConfigValue {
     config: FloeConfig;
@@ -165,6 +167,13 @@ export type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T ext
     [K in keyof T]?: DeepPartial<T[K]>;
 } : T;
 export declare const DEFAULT_FLOE_CONFIG: FloeConfig;
+/**
+ * Install page lifecycle listeners that flush pending debounced saves.
+ *
+ * Keep this side-effect separate from createPersist() so importing the module does not
+ * register global listeners (important for testability and predictable composition).
+ */
+export declare function installPersistFlushListeners(persist: Pick<PersistApi, 'flush'>): () => void;
 export interface FloeConfigProviderProps {
     config?: DeepPartial<FloeConfig>;
     children: JSX.Element;

package/dist/context/FloeConfigContext.js

@@ -1,5 +1,5 @@
-import { createComponent as I } from "solid-js/web";
-import { createContext as b, createMemo as u, useContext as h } from "solid-js";
+import { createComponent as C } from "solid-js/web";
+import { createContext as F, createMemo as u, createEffect as I, onCleanup as E, useContext as h } from "solid-js";
 const m = {
   storage: {
     namespace: "floe",
@@ -70,7 +70,7 @@ const m = {
     }
   }
 };
-function F() {
+function S() {
   if (!(typeof window > "u"))
     return {
       getItem: (e) => localStorage.getItem(e),
@@ -80,79 +80,108 @@ function F() {
     };
 }
 function v(e) {
-  const t = e.adapter ?? F(), c = e.namespace ? `${e.namespace}-` : "", i = (n) => `${c}${n}`, o = () => e.enabled && !!t, a = /* @__PURE__ */ new Map(), d = () => {
-    if (o()) {
-      for (const [n, r] of a.entries()) {
-        clearTimeout(r.timer);
+  const t = e.adapter ?? S(), c = e.namespace ? `${e.namespace}-` : "", r = (o) => `${c}${o}`, n = () => e.enabled && !!t, i = /* @__PURE__ */ new Map(), d = () => {
+    if (n()) {
+      for (const [o, a] of i.entries()) {
+        clearTimeout(a.timer);
         try {
-          t.setItem(n, JSON.stringify(r.value));
+          t.setItem(o, JSON.stringify(a.value));
         } catch (s) {
-          console.warn(`Failed to save ${n}:`, s);
+          console.warn(`Failed to save ${o}:`, s);
         }
       }
-      a.clear();
+      i.clear();
     }
   };
-  if (typeof window < "u")
-    try {
-      window.addEventListener("pagehide", d), window.addEventListener("beforeunload", d), typeof document < "u" && document.addEventListener("visibilitychange", () => {
-        document.visibilityState === "hidden" && d();
-      });
-    } catch {
-    }
   return {
-    key: i,
-    load: (n, r) => {
-      if (!o()) return r;
+    key: r,
+    load: (o, a) => {
+      if (!n()) return a;
       try {
-        const s = t.getItem(i(n));
-        return s === null ? r : JSON.parse(s);
+        const s = t.getItem(r(o));
+        return s === null ? a : JSON.parse(s);
       } catch {
-        return r;
+        return a;
       }
     },
-    save: (n, r) => {
-      if (o())
+    save: (o, a) => {
+      if (n())
         try {
-          t.setItem(i(n), JSON.stringify(r));
+          t.setItem(r(o), JSON.stringify(a));
         } catch (s) {
-          console.warn(`Failed to save ${i(n)}:`, s);
+          console.warn(`Failed to save ${r(o)}:`, s);
         }
     },
-    debouncedSave: (n, r, s = 300) => {
-      if (!o()) return;
-      const l = i(n), g = a.get(l);
-      g && clearTimeout(g.timer);
-      const p = setTimeout(() => {
-        const f = a.get(l);
-        if (!(!f || f.timer !== p)) {
-          a.delete(l);
+    debouncedSave: (o, a, s = 300) => {
+      if (!n()) return;
+      const l = r(o), p = i.get(l);
+      p && clearTimeout(p.timer);
+      const g = setTimeout(() => {
+        const f = i.get(l);
+        if (!(!f || f.timer !== g)) {
+          i.delete(l);
           try {
             t.setItem(l, JSON.stringify(f.value));
-          } catch (C) {
-            console.warn(`Failed to save ${l}:`, C);
+          } catch (b) {
+            console.warn(`Failed to save ${l}:`, b);
           }
         }
       }, s);
-      a.set(l, {
-        timer: p,
-        value: r
+      i.set(l, {
+        timer: g,
+        value: a
       });
     },
-    remove: (n) => {
-      if (o())
+    remove: (o) => {
+      if (n())
         try {
-          t.removeItem(i(n));
+          t.removeItem(r(o));
         } catch {
         }
     },
     clearAll: () => {
-      if (!o()) return;
-      const n = t.keys?.() ?? [];
-      for (const r of n)
-        r.startsWith(c) && t.removeItem(r);
+      if (!n()) return;
+      const o = t.keys?.() ?? [];
+      for (const a of o)
+        a.startsWith(c) && t.removeItem(a);
     },
-    flush: d
+    flush: d,
+    dispose: () => {
+      try {
+        d();
+      } finally {
+        for (const o of i.values())
+          clearTimeout(o.timer);
+        i.clear();
+      }
+    }
+  };
+}
+function k(e) {
+  if (typeof window > "u") return () => {
+  };
+  const t = () => {
+    try {
+      e.flush?.();
+    } catch {
+    }
+  }, c = () => t(), r = () => t(), n = () => {
+    try {
+      typeof document < "u" && document.visibilityState === "hidden" && t();
+    } catch {
+    }
+  };
+  try {
+    window.addEventListener("pagehide", c), window.addEventListener("beforeunload", r), typeof document < "u" && document.addEventListener("visibilitychange", n);
+  } catch {
+    return () => {
+    };
+  }
+  return () => {
+    try {
+      window.removeEventListener("pagehide", c), window.removeEventListener("beforeunload", r), typeof document < "u" && document.removeEventListener("visibilitychange", n);
+    } catch {
+    }
   };
 }
 function w(e, t) {
@@ -161,44 +190,53 @@ function w(e, t) {
   const c = {
     ...e
   };
-  for (const [i, o] of Object.entries(t)) {
-    if (o === void 0) continue;
-    const a = e[i];
-    typeof a == "object" && a !== null && typeof o == "object" && o !== null && !Array.isArray(o) ? c[i] = w(a, o) : c[i] = o;
+  for (const [r, n] of Object.entries(t)) {
+    if (n === void 0) continue;
+    const i = e[r];
+    typeof i == "object" && i !== null && typeof n == "object" && n !== null && !Array.isArray(n) ? c[r] = w(i, n) : c[r] = n;
   }
   return c;
 }
-const y = b();
-function A(e) {
-  const t = u(() => w(m, e.config)), c = u(() => v(t().storage)), i = u(() => ({
+const y = F();
+function O(e) {
+  const t = u(() => w(m, e.config)), c = u(() => v(t().storage));
+  I(() => {
+    const n = c(), d = t().storage.enabled ? k(n) : () => {
+    };
+    E(() => {
+      d(), n.dispose?.();
+    });
+  });
+  const r = u(() => ({
     config: t(),
     persist: c()
   }));
-  return I(y.Provider, {
+  return C(y.Provider, {
     get value() {
-      return i();
+      return r();
     },
     get children() {
       return e.children;
     }
   });
 }
-function E() {
+function D() {
   const e = h(y);
   if (!e)
     throw new Error("FloeConfigContext not found. Make sure to wrap your app with FloeConfigProvider (or FloeProvider).");
   return e;
 }
-const S = v(m.storage), k = {
+const L = v(m.storage), T = {
   config: m,
-  persist: S
+  persist: L
 };
-function L() {
-  return h(y) ?? k;
+function N() {
+  return h(y) ?? T;
 }
 export {
   m as DEFAULT_FLOE_CONFIG,
-  A as FloeConfigProvider,
-  E as useFloeConfig,
-  L as useResolvedFloeConfig
+  O as FloeConfigProvider,
+  k as installPersistFlushListeners,
+  D as useFloeConfig,
+  N as useResolvedFloeConfig
 };

package/dist/context/createSimpleContext.d.ts

@@ -11,5 +11,7 @@ export declare function createSimpleContext<T>(options: {
         children: JSX.Element;
     }) => JSX.Element;
     use: () => T;
+    useOptional: () => T | undefined;
+    has: () => boolean;
     Context: import("solid-js").Context<T | undefined>;
 };

package/dist/context/createSimpleContext.js

@@ -1,28 +1,36 @@
-import { createComponent as i } from "solid-js/web";
-import { createContext as u, useContext as m } from "solid-js";
-function x(t) {
-  const r = u();
-  function n(e) {
-    const c = t.init();
-    return i(r.Provider, {
+import { createComponent as a } from "solid-js/web";
+import { createContext as f, useContext as m } from "solid-js";
+function p(e) {
+  const n = f();
+  function o(t) {
+    const c = e.init();
+    return a(n.Provider, {
       value: c,
       get children() {
-        return e.children;
+        return t.children;
       }
     });
   }
-  function o() {
-    const e = m(r);
-    if (!e)
-      throw new Error(`${t.name}Context not found. Make sure to wrap your component with ${t.name}Provider.`);
-    return e;
+  function r() {
+    return m(n);
+  }
+  function u() {
+    const t = r();
+    if (!t)
+      throw new Error(`${e.name}Context not found. Make sure to wrap your component with ${e.name}Provider.`);
+    return t;
+  }
+  function i() {
+    return r() !== void 0;
   }
   return {
-    Provider: n,
-    use: o,
-    Context: r
+    Provider: o,
+    use: u,
+    useOptional: r,
+    has: i,
+    Context: n
   };
 }
 export {
-  x as createSimpleContext
+  p as createSimpleContext
 };

package/dist/context/index.d.ts

@@ -4,7 +4,7 @@ export { ThemeProvider, useTheme, createThemeService, type ThemeContextValue } f
 export { LayoutProvider, useLayout, createLayoutService, type LayoutContextValue } from './LayoutContext';
 export { CommandProvider, useCommand, createCommandService, type Command, type CommandContextValue } from './CommandContext';
 export { NotificationProvider, useNotification, createNotificationService, NotificationContainer, type Notification, type NotificationType, type NotificationContextValue, } from './NotificationContext';
-export { ComponentRegistryProvider, useComponentRegistry, useComponentContextFactory, createComponentRegistry, type FloeComponent, type ComponentContext, type CommandContribution, type StatusBarContribution, type ComponentRegistryValue, } from './ComponentRegistry';
+export { ComponentRegistryProvider, useComponentRegistry, useOptionalComponentRegistry, hasComponentRegistryContext, useComponentContextFactory, createComponentRegistry, type FloeComponent, type ComponentContext, type CommandContribution, type StatusBarContribution, type ComponentRegistryValue, } from './ComponentRegistry';
 export { WidgetRegistryProvider, useWidgetRegistry, createWidgetRegistry, type WidgetDefinition, type WidgetProps, type WidgetRegistryValue, } from './WidgetRegistry';
 export { DeckProvider, useDeck, createDeckService, type DeckWidget, type DeckLayout, type DragState, type ResizeState, type DeckContextValue, } from './DeckContext';
 export { WidgetStateProvider, useWidgetStateContext, useWidgetState, useCurrentWidgetId, type WidgetStateContextValue, type WidgetStateProviderProps, } from './WidgetStateContext';