@floegence/floe-webapp-core 0.65.0 → 0.65.1

package/dist/app/ActivityAppsMain.d.ts

@@ -23,5 +23,7 @@ export interface ActivityAppsMainProps<TProtocol = unknown> {
     activationMode?: KeepAliveStackProps['activationMode'];
     /** Target-local loading UI; leaves shell navigation available while a lazy page resolves. */
     renderFallback?: KeepAliveStackProps['renderFallback'];
+    /** Target-local error UI; the host chooses recovery without discarding other views. */
+    renderError?: KeepAliveStackProps['renderError'];
 }
 export declare function ActivityAppsMain<TProtocol = unknown>(props: ActivityAppsMainProps<TProtocol>): import("solid-js").JSX.Element;

package/dist/app/ActivityAppsMain.js

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

package/dist/app/createDocumentAssetRecovery.d.ts

@@ -0,0 +1,22 @@
+import { type Accessor } from 'solid-js';
+export type DocumentAssetRecoveryReason = 'updated' | 'load-failed' | null;
+export type DocumentAssetCheckResult = 'current' | 'updated' | 'unavailable';
+export interface DocumentAssetRecovery {
+    reason: Accessor<DocumentAssetRecoveryReason>;
+    checking: Accessor<boolean>;
+    /** Call after connectivity returns. No polling, navigation, or automatic reload is performed. */
+    check: () => Promise<DocumentAssetCheckResult>;
+}
+export interface DocumentAssetRecoveryOptions {
+    /** Stable HTML entry URL. The host supplies routing and authorization. */
+    url: string;
+    fetch?: typeof globalThis.fetch;
+    document?: Document;
+    timeoutMs?: number;
+}
+/**
+ * Detect a changed ESM application entry and observe Vite import failures.
+ * The loaded document remains authoritative until the user chooses to reload:
+ * checking never resets drafts, remounts views, or silently accepts a new build.
+ */
+export declare function createDocumentAssetRecovery(options: DocumentAssetRecoveryOptions): DocumentAssetRecovery;

package/dist/app/createDocumentAssetRecovery.js

@@ -0,0 +1,44 @@
+import { createSignal as b, onCleanup as L } from "solid-js";
+function g(e, t) {
+  const r = [...e.querySelectorAll('script[type="module"][src]')].map((a) => new URL(a.getAttribute("src"), t).href);
+  return r.length ? JSON.stringify(r.sort()) : null;
+}
+function A(e) {
+  const t = e.document ?? document, r = t.defaultView ?? window, a = new URL(e.url, t.baseURI).href, c = g(t, t.baseURI), p = e.fetch ?? globalThis.fetch.bind(globalThis), [u, d] = b(null), [w, f] = b(!1);
+  let l = !1, n, i;
+  const m = () => {
+    if (l || !c) return Promise.resolve("unavailable");
+    if (n) return n;
+    const s = new AbortController();
+    i = s;
+    const y = setTimeout(() => s.abort(), e.timeoutMs ?? 1e4);
+    return f(!0), n = Promise.resolve().then(async () => {
+      try {
+        const o = await p(a, {
+          cache: "no-store",
+          redirect: "error",
+          signal: s.signal,
+          headers: { Accept: "text/html" }
+        });
+        if (!o.ok || o.redirected || !o.headers.get("content-type")?.toLowerCase().includes("text/html"))
+          return "unavailable";
+        const x = await o.text();
+        if (l || s.signal.aborted) return "unavailable";
+        const v = g(new DOMParser().parseFromString(x, "text/html"), o.url || a);
+        return v ? v !== c ? (d("updated"), "updated") : "current" : "unavailable";
+      } catch {
+        return "unavailable";
+      } finally {
+        clearTimeout(y), i = void 0, n = void 0, l || f(!1);
+      }
+    }), n;
+  }, h = () => {
+    u() !== "updated" && d("load-failed"), m();
+  };
+  return r.addEventListener("vite:preloadError", h), L(() => {
+    l = !0, i?.abort(), r.removeEventListener("vite:preloadError", h);
+  }), { reason: u, checking: w, check: m };
+}
+export {
+  A as createDocumentAssetRecovery
+};

package/dist/app/index.d.ts

@@ -1,5 +1,6 @@
 export { FloeProvider, type FloeProviderProps } from './FloeProvider';
 export { FloeApp, type FloeAppProps } from './FloeApp';
 export { ActivityAppsMain, type ActivityAppsMainProps } from './ActivityAppsMain';
+export { createDocumentAssetRecovery, type DocumentAssetRecovery, type DocumentAssetRecoveryOptions, type DocumentAssetRecoveryReason, type DocumentAssetCheckResult } from './createDocumentAssetRecovery';
 export { FloeRegistryRuntime, type FloeRegistryRuntimeProps } from './FloeRegistryRuntime';
 export { FloeRegistryContributions, type FloeRegistryContributionsProps, } from './FloeRegistryContributions';

package/dist/app.js

@@ -1,12 +1,14 @@
-import { ActivityAppsMain as e } from "./app/ActivityAppsMain.js";
-import { FloeApp as i } from "./app/FloeApp.js";
+import { ActivityAppsMain as r } from "./app/ActivityAppsMain.js";
+import { FloeApp as p } from "./app/FloeApp.js";
 import { FloeProvider as m } from "./app/FloeProvider.js";
-import { FloeRegistryContributions as x } from "./app/FloeRegistryContributions.js";
+import { FloeRegistryContributions as s } from "./app/FloeRegistryContributions.js";
 import { FloeRegistryRuntime as n } from "./app/FloeRegistryRuntime.js";
+import { createDocumentAssetRecovery as l } from "./app/createDocumentAssetRecovery.js";
 export {
-  e as ActivityAppsMain,
-  i as FloeApp,
+  r as ActivityAppsMain,
+  p as FloeApp,
   m as FloeProvider,
-  x as FloeRegistryContributions,
-  n as FloeRegistryRuntime
+  s as FloeRegistryContributions,
+  n as FloeRegistryRuntime,
+  l as createDocumentAssetRecovery
 };

package/dist/components/layout/KeepAliveStack.d.ts

@@ -16,5 +16,7 @@ export interface KeepAliveStackProps {
     activationMode?: 'sync' | 'after-paint';
     /** Optional per-view Suspense boundary. The host owns localized loading presentation. */
     renderFallback?: (id: string) => JSX.Element;
+    /** Isolate a failed view without disposing its siblings. Reset does not retry cached dynamic imports. */
+    renderError?: (error: unknown, reset: () => void, id: string) => JSX.Element;
 }
 export declare function KeepAliveStack(props: KeepAliveStackProps): JSX.Element;

package/dist/components/layout/KeepAliveStack.js

@@ -1,171 +1,179 @@
-import { insert as P, createComponent as g, effect as B, className as E, setStyleProperty as K, template as R, memo as N, setAttribute as z } from "solid-js/web";
-import { createMemo as S, createSignal as k, untrack as F, createEffect as x, For as j, createRenderEffect as D, onCleanup as G, Suspense as H } from "solid-js";
-import { ViewActivationProvider as J } from "../../context/ViewActivationContext.js";
-import { cn as V } from "../../utils/cn.js";
-import { deferAfterPaint as L } from "../../utils/defer.js";
+import { insert as B, createComponent as y, effect as C, className as P, setStyleProperty as K, template as R, memo as N, setAttribute as q } from "solid-js/web";
+import { createMemo as S, createSignal as I, untrack as x, createEffect as E, For as j, createRenderEffect as D, onCleanup as G, ErrorBoundary as H, Suspense as J } from "solid-js";
+import { ViewActivationProvider as L } from "../../context/ViewActivationContext.js";
+import { cn as z } from "../../utils/cn.js";
+import { deferAfterPaint as Q } from "../../utils/defer.js";
 var O = /* @__PURE__ */ R("<div>");
 function M(e) {
   return String(e ?? "").trim();
 }
-function C(e) {
-  const u = [], s = /* @__PURE__ */ new Set();
-  for (const f of e) {
-    const a = M(f?.id);
-    a && (s.has(a) || (s.add(a), u.push(a)));
+function V(e) {
+  const s = [], u = /* @__PURE__ */ new Set();
+  for (const l of e) {
+    const a = M(l?.id);
+    a && (u.has(a) || (u.add(a), s.push(a)));
   }
-  return u;
+  return s;
 }
-function Q(e, u) {
-  const s = new Set(e), f = /* @__PURE__ */ new Map();
-  for (const a of u) {
+function T(e, s) {
+  const u = new Set(e), l = /* @__PURE__ */ new Map();
+  for (const a of s) {
     const d = M(a?.id);
-    d && s.has(d) && (f.has(d) || f.set(d, a));
+    d && u.has(d) && (l.has(d) || l.set(d, a));
   }
-  return f;
+  return l;
 }
-function T(e) {
-  const [u, s] = k(0), [f, a] = k(!1);
+function U(e) {
+  const [s, u] = I(0), [l, a] = I(!1);
   let d = 0;
   D(() => {
-    const c = e.active(), t = e.activationMode();
+    const r = e.active(), i = e.activationMode();
     d += 1;
     const h = d;
-    if (!c) {
+    if (!r) {
       a(!1);
       return;
     }
-    const v = () => {
-      h !== d || !e.active() || F(f) || (a(!0), s((w) => w + 1));
+    const f = () => {
+      h !== d || !e.active() || x(l) || (a(!0), u((m) => m + 1));
     };
-    t === "after-paint" ? L(v) : v();
+    i === "after-paint" ? Q(f) : f();
   }), G(() => {
     d += 1;
   });
-  const A = F(() => ({
+  const A = x(() => ({
     id: e.id,
     visible: e.active,
-    active: f,
-    activationSeq: u
-  }));
-  return g(J, {
+    active: l,
+    activationSeq: s
+  })), v = () => e.renderFallback ? y(J, {
+    get fallback() {
+      return e.renderFallback(e.id);
+    },
+    get children() {
+      return e.children;
+    }
+  }) : e.children;
+  return y(L, {
     value: A,
     get children() {
-      var c = O();
-      return P(c, (() => {
-        var t = N(() => !!e.renderFallback);
-        return () => t() ? g(H, {
-          get fallback() {
-            return e.renderFallback(e.id);
-          },
+      var r = O();
+      return B(r, (() => {
+        var i = N(() => !!e.renderError);
+        return () => i() ? y(H, {
+          fallback: (h, f) => e.renderError(h, f, e.id),
           get children() {
-            return e.children;
+            return v();
           }
-        }) : e.children;
-      })()), B((t) => {
-        var h = e.class, v = e.id, w = e.active() ? void 0 : "true", b = !e.active(), y = e.active() ? "block" : "none";
-        return h !== t.e && E(c, t.e = h), v !== t.t && z(c, "data-floe-keep-alive-view", t.t = v), w !== t.a && z(c, "aria-hidden", t.a = w), b !== t.o && (c.inert = t.o = b), y !== t.i && K(c, "display", t.i = y), t;
+        }) : v();
+      })()), C((i) => {
+        var h = e.class, f = e.id, m = e.active() ? void 0 : "true", g = !e.active(), t = e.active() ? "block" : "none";
+        return h !== i.e && P(r, i.e = h), f !== i.t && q(r, "data-floe-keep-alive-view", i.t = f), m !== i.a && q(r, "aria-hidden", i.a = m), g !== i.o && (r.inert = i.o = g), t !== i.i && K(r, "display", i.i = t), i;
       }, {
         e: void 0,
         t: void 0,
         a: void 0,
         o: void 0,
         i: void 0
-      }), c;
+      }), r;
     }
   });
 }
-function _(e) {
-  const u = () => e.lazyMount !== !1, s = () => e.keepMounted !== !1, f = () => e.activationMode ?? "sync", a = S(() => C(e.views)), [d, A] = k(F(() => Q(C(e.views), e.views))), c = S(() => M(e.activeId));
-  x(() => {
-    const n = a(), i = e.views;
-    A((r) => {
+function $(e) {
+  const s = () => e.lazyMount !== !1, u = () => e.keepMounted !== !1, l = () => e.activationMode ?? "sync", a = S(() => V(e.views)), [d, A] = I(x(() => T(V(e.views), e.views))), v = S(() => M(e.activeId));
+  E(() => {
+    const t = a(), n = e.views;
+    A((c) => {
       let o = !1;
-      const l = new Map(r), q = new Set(n);
-      for (const m of l.keys())
-        q.has(m) || (l.delete(m), o = !0);
-      for (const m of i) {
-        const I = M(m?.id);
-        I && q.has(I) && (l.has(I) || (l.set(I, m), o = !0));
+      const w = new Map(c), F = new Set(t);
+      for (const b of w.keys())
+        F.has(b) || (w.delete(b), o = !0);
+      for (const b of n) {
+        const k = M(b?.id);
+        k && F.has(k) && (w.has(k) || (w.set(k, b), o = !0));
       }
-      return o ? l : r;
+      return o ? w : c;
     });
   });
-  const t = S(() => ({
+  const r = S(() => ({
     order: a(),
     byId: d()
-  })), h = () => {
-    if (!s()) return /* @__PURE__ */ new Set();
-    if (!u()) return new Set(t().order);
-    const n = c();
-    return n ? t().byId.has(n) ? /* @__PURE__ */ new Set([n]) : /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set();
-  }, [v, w] = k(h());
-  x(() => {
-    if (!s()) return;
-    const n = new Set(t().order);
-    w((i) => {
-      let r = !1;
+  })), i = () => {
+    if (!u()) return /* @__PURE__ */ new Set();
+    if (!s()) return new Set(r().order);
+    const t = v();
+    return t ? r().byId.has(t) ? /* @__PURE__ */ new Set([t]) : /* @__PURE__ */ new Set() : /* @__PURE__ */ new Set();
+  }, [h, f] = I(i());
+  E(() => {
+    if (!u()) return;
+    const t = new Set(r().order);
+    f((n) => {
+      let c = !1;
       const o = /* @__PURE__ */ new Set();
-      for (const l of i) {
-        if (!n.has(l)) {
-          r = !0;
+      for (const w of n) {
+        if (!t.has(w)) {
+          c = !0;
           continue;
         }
-        o.add(l);
+        o.add(w);
       }
-      return r ? o : i;
+      return c ? o : n;
     });
-  }), x(() => {
-    if (!s() || !u()) return;
-    const n = c();
-    n && t().byId.has(n) && w((i) => {
-      if (i.has(n)) return i;
-      const r = new Set(i);
-      return r.add(n), r;
+  }), E(() => {
+    if (!u() || !s()) return;
+    const t = v();
+    t && r().byId.has(t) && f((n) => {
+      if (n.has(t)) return n;
+      const c = new Set(n);
+      return c.add(t), c;
     });
   });
-  const b = S(() => {
-    const n = t().order, i = c();
-    if (!s())
-      return i ? t().byId.has(i) ? [i] : [] : [];
-    if (!u()) return n;
-    const r = v();
-    return n.filter((o) => r.has(o) || o === i);
-  }), y = S(() => {
-    const n = c();
-    return n ? t().byId.has(n) : !1;
+  const m = S(() => {
+    const t = r().order, n = v();
+    if (!u())
+      return n ? r().byId.has(n) ? [n] : [] : [];
+    if (!s()) return t;
+    const c = h();
+    return t.filter((o) => c.has(o) || o === n);
+  }), g = S(() => {
+    const t = v();
+    return t ? r().byId.has(t) : !1;
   });
   return (() => {
-    var n = O();
-    return P(n, g(j, {
+    var t = O();
+    return B(t, y(j, {
       get each() {
-        return b();
+        return m();
       },
-      children: (i) => {
-        const r = () => d().get(i);
-        return g(T, {
-          id: i,
-          active: () => c() === i,
-          activationMode: f,
+      children: (n) => {
+        const c = () => d().get(n);
+        return y(U, {
+          id: n,
+          active: () => v() === n,
+          activationMode: l,
           get renderFallback() {
             return e.renderFallback;
           },
+          get renderError() {
+            return e.renderError;
+          },
           get class() {
-            return V("absolute inset-0", r()?.class);
+            return z("absolute inset-0", c()?.class);
           },
           get children() {
-            return r()?.render();
+            return c()?.render();
           }
         });
       }
-    })), B((i) => {
-      var r = V("relative h-full min-h-0 w-full", e.class), o = y() ? "block" : "none";
-      return r !== i.e && E(n, i.e = r), o !== i.t && K(n, "display", i.t = o), i;
+    })), C((n) => {
+      var c = z("relative h-full min-h-0 w-full", e.class), o = g() ? "block" : "none";
+      return c !== n.e && P(t, n.e = c), o !== n.t && K(t, "display", n.t = o), n;
     }, {
       e: void 0,
       t: void 0
-    }), n;
+    }), t;
   })();
 }
 export {
-  _ as KeepAliveStack
+  $ as KeepAliveStack
 };