@treasuryspatial/viewer-react 0.1.28 → 0.1.32

package/dist/useClientHydrated.d.ts

@@ -0,0 +1,2 @@
+export declare function useClientHydrated(): boolean;
+//# sourceMappingURL=useClientHydrated.d.ts.map

package/dist/useClientHydrated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClientHydrated.d.ts","sourceRoot":"","sources":["../src/useClientHydrated.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C"}

package/dist/useClientHydrated.js

@@ -0,0 +1,8 @@
+import { useEffect, useState } from "react";
+export function useClientHydrated() {
+    const [hydrated, setHydrated] = useState(false);
+    useEffect(() => {
+        setHydrated(true);
+    }, []);
+    return hydrated;
+}

package/dist/useComposerAuthState.js

@@ -20,7 +20,7 @@ export function useComposerAuthState(options = {}) {
             isAuthenticated,
         };
     }, [adminRoleValue, nameCookieKey, roleCookieKey, userCookieKey]);
-    const initial = useMemo(() => {
+    const contextAuth = useMemo(() => {
         const fromContext = sessionContext?.auth ?? null;
         if (fromContext && typeof fromContext === "object") {
             return {
@@ -30,9 +30,14 @@ export function useComposerAuthState(options = {}) {
                 isAuthenticated: Boolean(fromContext.isAuthenticated),
             };
         }
-        return readAuth();
+        return null;
     }, [readAuth, sessionContext?.auth]);
-    const [auth, setAuth] = useState(initial);
+    const [auth, setAuth] = useState(contextAuth ?? {
+        user: null,
+        name: null,
+        isAdmin: false,
+        isAuthenticated: false,
+    });
     const syncContext = useCallback((next) => {
         if (!setSessionContext)
             return;
@@ -50,18 +55,10 @@ export function useComposerAuthState(options = {}) {
         syncContext(next);
     }, [readAuth, syncContext]);
     useEffect(() => {
-        if (!sessionContext)
-            return;
-        const fromContext = sessionContext.auth;
-        if (!fromContext)
+        if (!contextAuth)
             return;
-        setAuth({
-            user: fromContext.user ?? null,
-            name: fromContext.name ?? null,
-            isAdmin: Boolean(fromContext.isAdmin),
-            isAuthenticated: Boolean(fromContext.isAuthenticated),
-        });
-    }, [sessionContext?.auth]);
+        setAuth(contextAuth);
+    }, [contextAuth]);
     useEffect(() => {
         refresh();
     }, [refresh]);

package/dist/useComposerSurfaceBranch.d.ts

@@ -0,0 +1,11 @@
+import type { ComposerMode } from "./composerRouting";
+export type ComposerSurfaceBranch = "guide" | "loading" | "locked" | "gate" | "map-coming" | "runner";
+export type UseComposerSurfaceBranchOptions = {
+    hydrated: boolean;
+    mode: ComposerMode;
+    showGuide: boolean;
+    showLocked: boolean;
+    showGate: boolean;
+};
+export declare function useComposerSurfaceBranch({ hydrated, mode, showGuide, showLocked, showGate, }: UseComposerSurfaceBranchOptions): ComposerSurfaceBranch;
+//# sourceMappingURL=useComposerSurfaceBranch.d.ts.map

package/dist/useComposerSurfaceBranch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposerSurfaceBranch.d.ts","sourceRoot":"","sources":["../src/useComposerSurfaceBranch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAC7B,OAAO,GACP,SAAS,GACT,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,QAAQ,CAAC;AAEb,MAAM,MAAM,+BAA+B,GAAG;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,UAAU,EACV,QAAQ,GACT,EAAE,+BAA+B,GAAG,qBAAqB,CASzD"}

package/dist/useComposerSurfaceBranch.js

@@ -0,0 +1,16 @@
+import { useMemo } from "react";
+export function useComposerSurfaceBranch({ hydrated, mode, showGuide, showLocked, showGate, }) {
+    return useMemo(() => {
+        if (showGuide)
+            return "guide";
+        if (!hydrated)
+            return "loading";
+        if (showLocked)
+            return "locked";
+        if (showGate)
+            return "gate";
+        if (mode === "map")
+            return "map-coming";
+        return "runner";
+    }, [hydrated, mode, showGate, showGuide, showLocked]);
+}

package/dist/useGrasshopperSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGrasshopperSession.d.ts","sourceRoot":"","sources":["../src/useGrasshopperSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACb,MAAM,6BAA6B,CAAC;AAQrC,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAiGF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACnD,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrD,KAAK,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5F,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EACpC,QAA0B,EAC1B,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,OAAO,GACR,GAAE,yBAA8B,GAAG,uBAAuB,CA0H1D"}
+{"version":3,"file":"useGrasshopperSession.d.ts","sourceRoot":"","sources":["../src/useGrasshopperSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,EACb,MAAM,6BAA6B,CAAC;AAQrC,KAAK,iBAAiB,GAAG,gBAAgB,GAAG;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAiGF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QACnB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACnD,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,iBAAiB,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrD,KAAK,EAAE,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IAC5F,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EACpC,QAA0B,EAC1B,OAAO,EACP,kBAAkB,EAClB,UAAU,EACV,OAAO,GACR,GAAE,yBAA8B,GAAG,uBAAuB,CAgI1D"}

package/dist/useGrasshopperSession.js

@@ -113,7 +113,13 @@ export function useGrasshopperSession({ apiRoute = "/api/gh-solve", preview, all
                     id: "gh-inputs",
                     label: "grasshopper inputs",
                     description: "Inputs detected from the uploaded Grasshopper definition.",
-                    fields: inputs.map((input, index) => buildGhPanelField(input, index)),
+                    groups: [
+                        {
+                            id: "gh-inputs-main",
+                            label: "inputs",
+                            fields: inputs.map((input, index) => buildGhPanelField(input, index)),
+                        },
+                    ],
                 },
             ],
         };

package/dist/useModuleWorkspace.js

@@ -7,7 +7,7 @@ export function useModuleWorkspace({ enabled = true, registry, grasshopper, init
     const [sourceMode, setSourceMode] = useState(initialSourceMode);
     const handleUploadSolved = useCallback((result) => {
         ghSession.applyUploadResult(result);
-        if (result.kind === "grasshopper") {
+        if (result.kind === "grasshopper" || result.kind === "geometry3dm" || result.kind === "mesh") {
             setSourceMode("upload");
         }
     }, [ghSession]);

package/dist/usePromptPackSelectionByMode.d.ts

@@ -0,0 +1,33 @@
+export type PromptPackMode = "imagine" | "design" | "map";
+export type PromptPackRef = {
+    id?: string;
+    version?: string;
+};
+export type PromptPackSelectionByMode = Partial<Record<PromptPackMode, PromptPackRef>>;
+export type PromptPackCatalogEntry = {
+    id: string;
+    label: string;
+    version?: string;
+    description?: string;
+};
+export type UsePromptPackSelectionByModeOptions = {
+    mode: PromptPackMode;
+    catalog: PromptPackCatalogEntry[];
+    envSelection: PromptPackSelectionByMode;
+    overrideSelection?: PromptPackSelectionByMode | null;
+    sessionContext?: Record<string, unknown> | null;
+    setSessionContext?: (partial: Record<string, unknown>) => void;
+    contextKey?: string;
+    legacyContextKey?: string;
+};
+export declare const PROMPT_PACK_MODES: PromptPackMode[];
+export declare function usePromptPackSelectionByMode({ mode, catalog, envSelection, overrideSelection, sessionContext, setSessionContext, contextKey, legacyContextKey, }: UsePromptPackSelectionByModeOptions): {
+    activeRef: PromptPackRef | undefined;
+    activeLabel: string;
+    labelsByMode: Record<PromptPackMode, string>;
+    catalogById: Record<string, PromptPackCatalogEntry>;
+    setSelection: (mode: PromptPackMode, packId: string) => void;
+    resetSelection: () => void;
+    mergedSelection: PromptPackSelectionByMode;
+};
+//# sourceMappingURL=usePromptPackSelectionByMode.d.ts.map

package/dist/usePromptPackSelectionByMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromptPackSelectionByMode.d.ts","sourceRoot":"","sources":["../src/usePromptPackSelectionByMode.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;AAEvF,MAAM,MAAM,sBAAsB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,YAAY,EAAE,yBAAyB,CAAC;IACxC,iBAAiB,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChD,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,EAAiC,CAAC;AAiChF,wBAAgB,4BAA4B,CAAC,EAC3C,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,iBAAwB,EACxB,cAAqB,EACrB,iBAAiB,EACjB,UAAkC,EAClC,gBAAgD,GACjD,EAAE,mCAAmC,GAAG;IACvC,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACpD,YAAY,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,yBAAyB,CAAC;CAC5C,CAiFA"}

package/dist/usePromptPackSelectionByMode.js

@@ -0,0 +1,102 @@
+import { useCallback, useMemo } from "react";
+export const PROMPT_PACK_MODES = ["imagine", "design", "map"];
+const normalizeSelection = (raw) => {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const next = {};
+    PROMPT_PACK_MODES.forEach((mode) => {
+        const entry = raw[mode];
+        if (!entry || typeof entry !== "object" || Array.isArray(entry))
+            return;
+        const id = typeof entry.id === "string" ? entry.id?.trim() : undefined;
+        const version = typeof entry.version === "string" ? entry.version?.trim() : undefined;
+        if (id || version) {
+            next[mode] = { id: id || undefined, version: version || undefined };
+        }
+    });
+    return Object.keys(next).length ? next : null;
+};
+const mergeRef = (base, override) => {
+    const id = override?.id ?? base?.id;
+    const version = override?.version ?? base?.version;
+    if (!id && !version)
+        return undefined;
+    return { id, version };
+};
+const formatLabel = (ref, catalogById) => {
+    if (!ref?.id)
+        return "default";
+    const entry = catalogById[ref.id];
+    const label = entry?.label || ref.id;
+    const version = ref.version ?? entry?.version;
+    return version ? `${label}@${version}` : label;
+};
+export function usePromptPackSelectionByMode({ mode, catalog, envSelection, overrideSelection = null, sessionContext = null, setSessionContext, contextKey = "promptPackRefByMode", legacyContextKey = "promptPackRefByModeOverride", }) {
+    const catalogById = useMemo(() => Object.fromEntries(catalog.map((entry) => [entry.id, entry])), [catalog]);
+    const sessionSelection = useMemo(() => {
+        const raw = (sessionContext ?? {})[contextKey] ?? (sessionContext ?? {})[legacyContextKey];
+        return normalizeSelection(raw);
+    }, [contextKey, legacyContextKey, sessionContext]);
+    const mergedOverrides = useMemo(() => {
+        if (!overrideSelection && !sessionSelection)
+            return null;
+        return {
+            ...(overrideSelection ?? {}),
+            ...(sessionSelection ?? {}),
+        };
+    }, [overrideSelection, sessionSelection]);
+    const mergedSelection = useMemo(() => {
+        if (!mergedOverrides)
+            return envSelection;
+        return {
+            imagine: mergeRef(envSelection.imagine, mergedOverrides.imagine),
+            design: mergeRef(envSelection.design, mergedOverrides.design),
+            map: mergeRef(envSelection.map, mergedOverrides.map),
+        };
+    }, [envSelection, mergedOverrides]);
+    const activeRef = useMemo(() => mergedSelection[mode], [mergedSelection, mode]);
+    const activeLabel = useMemo(() => formatLabel(activeRef, catalogById), [activeRef, catalogById]);
+    const labelsByMode = useMemo(() => ({
+        imagine: formatLabel(mergedSelection.imagine, catalogById),
+        design: formatLabel(mergedSelection.design, catalogById),
+        map: formatLabel(mergedSelection.map, catalogById),
+    }), [catalogById, mergedSelection]);
+    const setSelection = useCallback((modeKey, packId) => {
+        if (!setSessionContext)
+            return;
+        const trimmedPackId = packId.trim();
+        const existing = (sessionSelection ?? {});
+        const next = { ...existing };
+        if (!trimmedPackId) {
+            delete next[modeKey];
+        }
+        else {
+            const catalogEntry = catalogById[trimmedPackId];
+            next[modeKey] = {
+                id: trimmedPackId,
+                version: catalogEntry?.version || undefined,
+            };
+        }
+        setSessionContext({
+            [contextKey]: Object.keys(next).length ? next : null,
+            [legacyContextKey]: null,
+        });
+    }, [catalogById, contextKey, legacyContextKey, sessionSelection, setSessionContext]);
+    const resetSelection = useCallback(() => {
+        if (!setSessionContext)
+            return;
+        setSessionContext({
+            [contextKey]: null,
+            [legacyContextKey]: null,
+        });
+    }, [contextKey, legacyContextKey, setSessionContext]);
+    return {
+        activeRef,
+        activeLabel,
+        labelsByMode,
+        catalogById,
+        setSelection,
+        resetSelection,
+        mergedSelection,
+    };
+}

package/dist/useSessionLogout.d.ts

@@ -0,0 +1,9 @@
+import { type SessionCookieKeys } from "./sessionAuth";
+export type UseSessionLogoutOptions = {
+    logoutRoute?: string;
+    redirectPath?: string;
+    cookieKeys?: SessionCookieKeys;
+    onRedirect?: (path: string) => void;
+};
+export declare function useSessionLogout({ logoutRoute, redirectPath, cookieKeys, onRedirect, }?: UseSessionLogoutOptions): () => void;
+//# sourceMappingURL=useSessionLogout.d.ts.map

package/dist/useSessionLogout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionLogout.d.ts","sourceRoot":"","sources":["../src/useSessionLogout.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAC/B,WAAwC,EACxC,YAAuB,EACvB,UAAU,EACV,UAAU,GACX,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAc3C"}

package/dist/useSessionLogout.js

@@ -0,0 +1,17 @@
+import { useCallback } from "react";
+import { clearSessionCookies } from "./sessionAuth";
+export function useSessionLogout({ logoutRoute = "/api/auth/session/logout", redirectPath = "/login", cookieKeys, onRedirect, } = {}) {
+    return useCallback(() => {
+        fetch(logoutRoute, { method: "POST" }).catch(() => {
+            // ignore logout sync failures
+        });
+        clearSessionCookies(cookieKeys);
+        if (onRedirect) {
+            onRedirect(redirectPath);
+            return;
+        }
+        if (typeof window !== "undefined") {
+            window.location.href = redirectPath;
+        }
+    }, [cookieKeys, logoutRoute, onRedirect, redirectPath]);
+}

package/dist/useSessionRevocationPing.d.ts

@@ -0,0 +1,8 @@
+export type UseSessionRevocationPingOptions = {
+    enabled: boolean;
+    pingRoute?: string;
+    intervalMs?: number;
+    onRevoked?: () => void;
+};
+export declare function useSessionRevocationPing({ enabled, pingRoute, intervalMs, onRevoked, }: UseSessionRevocationPingOptions): void;
+//# sourceMappingURL=useSessionRevocationPing.d.ts.map

package/dist/useSessionRevocationPing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSessionRevocationPing.d.ts","sourceRoot":"","sources":["../src/useSessionRevocationPing.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,EACvC,OAAO,EACP,SAAoC,EACpC,UAAmB,EACnB,SAAS,GACV,EAAE,+BAA+B,QA2BjC"}

package/dist/useSessionRevocationPing.js

@@ -0,0 +1,30 @@
+import { useEffect } from "react";
+export function useSessionRevocationPing({ enabled, pingRoute = "/api/auth/session/ping", intervalMs = 60_000, onRevoked, }) {
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let active = true;
+        const ping = async () => {
+            try {
+                const response = await fetch(pingRoute, { method: "POST" });
+                const data = await response.json().catch(() => null);
+                if (!active)
+                    return;
+                if (data?.revoked) {
+                    onRevoked?.();
+                }
+            }
+            catch {
+                // ignore ping failures
+            }
+        };
+        void ping();
+        const interval = window.setInterval(() => {
+            void ping();
+        }, intervalMs);
+        return () => {
+            active = false;
+            window.clearInterval(interval);
+        };
+    }, [enabled, intervalMs, onRevoked, pingRoute]);
+}

package/dist/useShellPanelToggle.d.ts

@@ -0,0 +1,12 @@
+export type UseShellPanelToggleOptions = {
+    enabled?: boolean;
+    bodyClassName?: string;
+    eventName?: string;
+};
+export type ShellPanelToggleState = {
+    collapsed: boolean;
+    toggle: () => void;
+    setCollapsed: (next: boolean) => void;
+};
+export declare function useShellPanelToggle({ enabled, bodyClassName, eventName, }?: UseShellPanelToggleOptions): ShellPanelToggleState;
+//# sourceMappingURL=useShellPanelToggle.d.ts.map

package/dist/useShellPanelToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useShellPanelToggle.d.ts","sourceRoot":"","sources":["../src/useShellPanelToggle.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,EAClC,OAAc,EACd,aAA+B,EAC/B,SAAiC,GAClC,GAAE,0BAA+B,GAAG,qBAAqB,CA2CzD"}

package/dist/useShellPanelToggle.js

@@ -0,0 +1,40 @@
+import { useCallback, useEffect, useState } from "react";
+export function useShellPanelToggle({ enabled = true, bodyClassName = "nav-collapsed", eventName = "treasury:nav-toggle", } = {}) {
+    const [collapsed, setCollapsedState] = useState(false);
+    const setCollapsed = useCallback((next) => {
+        setCollapsedState(next);
+        if (typeof document !== "undefined") {
+            document.body.classList.toggle(bodyClassName, next);
+        }
+        if (typeof window !== "undefined") {
+            window.dispatchEvent(new CustomEvent(eventName, { detail: { hidden: next } }));
+        }
+    }, [bodyClassName, eventName]);
+    useEffect(() => {
+        if (!enabled) {
+            setCollapsed(false);
+            return;
+        }
+        if (typeof document === "undefined" || typeof window === "undefined")
+            return;
+        setCollapsedState(document.body.classList.contains(bodyClassName));
+        const handleToggle = (event) => {
+            const detail = event.detail;
+            setCollapsedState(Boolean(detail?.hidden));
+        };
+        window.addEventListener(eventName, handleToggle);
+        return () => {
+            window.removeEventListener(eventName, handleToggle);
+        };
+    }, [bodyClassName, enabled, eventName, setCollapsed]);
+    const toggle = useCallback(() => {
+        if (!enabled)
+            return;
+        setCollapsed(!collapsed);
+    }, [collapsed, enabled, setCollapsed]);
+    return {
+        collapsed,
+        toggle,
+        setCollapsed,
+    };
+}

package/dist/useSurfaceWarmup.d.ts

@@ -0,0 +1,7 @@
+export type UseSurfaceWarmupOptions = {
+    enabled: boolean;
+    intervalMs?: number;
+    run: () => Promise<void>;
+};
+export declare function useSurfaceWarmup({ enabled, intervalMs, run }: UseSurfaceWarmupOptions): void;
+//# sourceMappingURL=useSurfaceWarmup.d.ts.map

package/dist/useSurfaceWarmup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceWarmup.d.ts","sourceRoot":"","sources":["../src/useSurfaceWarmup.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,uBAAuB,QA8BrF"}

package/dist/useSurfaceWarmup.js

@@ -0,0 +1,32 @@
+import { useEffect, useRef } from "react";
+export function useSurfaceWarmup({ enabled, intervalMs, run }) {
+    const warmupStartedRef = useRef(false);
+    const inFlightRef = useRef(false);
+    useEffect(() => {
+        if (!enabled || warmupStartedRef.current)
+            return;
+        warmupStartedRef.current = true;
+        const invoke = async () => {
+            if (inFlightRef.current)
+                return;
+            inFlightRef.current = true;
+            try {
+                await run();
+            }
+            finally {
+                inFlightRef.current = false;
+            }
+        };
+        void invoke();
+        if (!intervalMs || !Number.isFinite(intervalMs) || intervalMs <= 0)
+            return;
+        const interval = window.setInterval(() => {
+            if (document.visibilityState === "hidden")
+                return;
+            void invoke();
+        }, intervalMs);
+        return () => {
+            window.clearInterval(interval);
+        };
+    }, [enabled, intervalMs, run]);
+}

package/dist/useThemeMode.d.ts

@@ -0,0 +1,12 @@
+export type ThemeMode = "dark" | "light";
+export type UseThemeModeOptions = {
+    storageKey?: string;
+    attributeName?: string;
+    defaultTheme?: ThemeMode;
+};
+export declare function useThemeMode({ storageKey, attributeName, defaultTheme, }?: UseThemeModeOptions): {
+    theme: ThemeMode;
+    setTheme: (next: ThemeMode) => void;
+    toggleTheme: () => void;
+};
+//# sourceMappingURL=useThemeMode.d.ts.map

package/dist/useThemeMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeMode.d.ts","sourceRoot":"","sources":["../src/useThemeMode.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAC3B,UAA0B,EAC1B,aAA4B,EAC5B,YAAqB,GACtB,GAAE,mBAAwB,GAAG;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACpC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB,CA2BA"}

package/dist/useThemeMode.js

@@ -0,0 +1,26 @@
+import { useCallback, useEffect, useState } from "react";
+export function useThemeMode({ storageKey = "rv_theme_v2", attributeName = "data-theme", defaultTheme = "dark", } = {}) {
+    const [theme, setTheme] = useState(defaultTheme);
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const stored = window.localStorage.getItem(storageKey);
+        const prefersDark = window.matchMedia?.("(prefers-color-scheme: dark)").matches;
+        const resolved = stored === "light" || stored === "dark" ? stored : prefersDark ? "dark" : "light";
+        setTheme(resolved);
+    }, [storageKey]);
+    useEffect(() => {
+        if (typeof document === "undefined" || typeof window === "undefined")
+            return;
+        document.documentElement.setAttribute(attributeName, theme);
+        window.localStorage.setItem(storageKey, theme);
+    }, [attributeName, storageKey, theme]);
+    const toggleTheme = useCallback(() => {
+        setTheme((prev) => (prev === "dark" ? "light" : "dark"));
+    }, []);
+    return {
+        theme,
+        setTheme,
+        toggleTheme,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treasuryspatial/viewer-react",
-  "version": "0.1.28",
+  "version": "0.1.32",
   "type": "module",
   "license": "UNLICENSED",
   "main": "./dist/index.js",