@treasuryspatial/viewer-react 0.1.44 → 0.1.48

package/dist/useModeShellState.js

@@ -1,14 +1,16 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { resolveModeShellDefaults } from "@treasuryspatial/mode-policy";
+import { PANEL_COLLAPSE_BODY_CLASS, PANEL_COLLAPSE_EVENT } from "./useShellPanelToggle";
 const resolveBoolean = (value, fallback) => typeof value === "boolean" ? value : fallback;
 export function useModeShellState({ mode, policy, panelDefaultOpen = true, metricsDefaultOpen = false, inspectorDefaultOpen = false, enabled = true, }) {
     const shellDefaults = useMemo(() => resolveModeShellDefaults(mode, policy), [mode, policy]);
-    const [navHidden, setNavHidden] = useState(() => typeof document !== "undefined" && document.body.classList.contains("nav-collapsed"));
+    const [navHidden, setNavHidden] = useState(false);
     const [panelOpen, setPanelOpen] = useState(() => resolveBoolean(shellDefaults.leftPanelOpen, panelDefaultOpen));
     const [metricsOpen, setMetricsOpen] = useState(() => resolveBoolean(shellDefaults.metricsOpen, metricsDefaultOpen));
     const [inspectorOpen, setInspectorOpen] = useState(() => resolveBoolean(shellDefaults.inspectorOpen, inspectorDefaultOpen));
     const initializedRef = useRef(false);
     const savedStateRef = useRef(null);
+    const panelsCollapsedRef = useRef(false);
     useEffect(() => {
         const nextPanelOpen = resolveBoolean(shellDefaults.leftPanelOpen, panelDefaultOpen);
         const nextMetricsOpen = resolveBoolean(shellDefaults.metricsOpen, metricsDefaultOpen);
@@ -16,6 +18,17 @@ export function useModeShellState({ mode, policy, panelDefaultOpen = true, metri
         if (!initializedRef.current) {
             initializedRef.current = true;
         }
+        if (panelsCollapsedRef.current) {
+            savedStateRef.current = {
+                panelOpen: nextPanelOpen,
+                metricsOpen: nextMetricsOpen,
+                inspectorOpen: nextInspectorOpen,
+            };
+            setPanelOpen(false);
+            setMetricsOpen(false);
+            setInspectorOpen(false);
+            return;
+        }
         setPanelOpen(nextPanelOpen);
         setMetricsOpen(nextMetricsOpen);
         setInspectorOpen(nextInspectorOpen);
@@ -28,13 +41,33 @@ export function useModeShellState({ mode, policy, panelDefaultOpen = true, metri
         shellDefaults.metricsOpen,
     ]);
     useEffect(() => {
-        if (!enabled || typeof window === "undefined")
+        if (typeof window === "undefined")
             return;
+        const initialNavHidden = document.body.classList.contains("nav-collapsed");
+        const initialPanelsCollapsed = document.body.classList.contains(PANEL_COLLAPSE_BODY_CLASS);
+        setNavHidden(initialNavHidden);
+        panelsCollapsedRef.current = initialPanelsCollapsed;
+        if (initialPanelsCollapsed) {
+            savedStateRef.current = {
+                panelOpen: resolveBoolean(shellDefaults.leftPanelOpen, panelDefaultOpen),
+                metricsOpen: resolveBoolean(shellDefaults.metricsOpen, metricsDefaultOpen),
+                inspectorOpen: resolveBoolean(shellDefaults.inspectorOpen, inspectorDefaultOpen),
+            };
+            setPanelOpen(false);
+            setMetricsOpen(false);
+            setInspectorOpen(false);
+        }
         const handleNavToggle = (event) => {
             const detail = event.detail;
-            const hidden = Boolean(detail?.hidden);
-            setNavHidden(hidden);
-            if (hidden) {
+            setNavHidden(Boolean(detail?.hidden ?? detail?.collapsed));
+        };
+        const handlePanelsToggle = (event) => {
+            if (!enabled)
+                return;
+            const detail = event.detail;
+            const collapsed = Boolean(detail?.collapsed ?? detail?.hidden);
+            panelsCollapsedRef.current = collapsed;
+            if (collapsed) {
                 savedStateRef.current = { panelOpen, metricsOpen, inspectorOpen };
                 setPanelOpen(false);
                 setMetricsOpen(false);
@@ -49,10 +82,23 @@ export function useModeShellState({ mode, policy, panelDefaultOpen = true, metri
             }
         };
         window.addEventListener("treasury:nav-toggle", handleNavToggle);
+        window.addEventListener(PANEL_COLLAPSE_EVENT, handlePanelsToggle);
         return () => {
             window.removeEventListener("treasury:nav-toggle", handleNavToggle);
+            window.removeEventListener(PANEL_COLLAPSE_EVENT, handlePanelsToggle);
         };
-    }, [enabled, inspectorOpen, metricsOpen, panelOpen]);
+    }, [
+        enabled,
+        inspectorDefaultOpen,
+        inspectorOpen,
+        metricsDefaultOpen,
+        metricsOpen,
+        panelDefaultOpen,
+        panelOpen,
+        shellDefaults.inspectorOpen,
+        shellDefaults.leftPanelOpen,
+        shellDefaults.metricsOpen,
+    ]);
     return {
         navHidden,
         panelOpen,

package/dist/usePromptPackSelection.d.ts

@@ -0,0 +1,20 @@
+import { type PromptPackCatalogEntry, type PromptPackRef } from "@treasuryspatial/render-kit";
+import type { ComposerWorkspaceSession, ComposerWorkspaceSessionUpdater } from "./workspaceSession";
+export type UsePromptPackSelectionOptions<TDraft = unknown> = {
+    mode: string;
+    catalog: PromptPackCatalogEntry[];
+    envSelection?: PromptPackRef | null;
+    overrideSelection?: PromptPackRef | null;
+    locked?: boolean;
+    workspaceSession?: ComposerWorkspaceSession<TDraft> | null;
+    setWorkspaceSession?: (updater: ComposerWorkspaceSessionUpdater<TDraft>) => void;
+};
+export declare function usePromptPackSelection<TDraft = unknown>({ mode, catalog, envSelection, overrideSelection, locked, workspaceSession, setWorkspaceSession, }: UsePromptPackSelectionOptions<TDraft>): {
+    activeRef: PromptPackRef | undefined;
+    activeLabel: string;
+    catalogById: Record<string, PromptPackCatalogEntry>;
+    setSelection: (packId: string) => void;
+    resetSelection: () => void;
+    mergedSelection: PromptPackRef | undefined;
+};
+//# sourceMappingURL=usePromptPackSelection.d.ts.map

package/dist/usePromptPackSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePromptPackSelection.d.ts","sourceRoot":"","sources":["../src/usePromptPackSelection.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAEpG,MAAM,MAAM,6BAA6B,CAAC,MAAM,GAAG,OAAO,IAAI;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,YAAY,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,iBAAiB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3D,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE,+BAA+B,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CAClF,CAAC;AA+BF,wBAAgB,sBAAsB,CAAC,MAAM,GAAG,OAAO,EAAE,EACvD,IAAI,EACJ,OAAO,EACP,YAAmB,EACnB,iBAAwB,EACxB,MAAc,EACd,gBAAuB,EACvB,mBAAmB,GACpB,EAAE,6BAA6B,CAAC,MAAM,CAAC,GAAG;IACzC,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACpD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,eAAe,EAAE,aAAa,GAAG,SAAS,CAAC;CAC5C,CAkEA"}

package/dist/usePromptPackSelection.js

@@ -0,0 +1,81 @@
+import { useCallback, useMemo } from "react";
+const trimOptional = (value) => {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+};
+const normalizePromptPackRef = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const id = trimOptional(value.id);
+    const version = trimOptional(value.version);
+    if (!id && !version)
+        return undefined;
+    return {
+        ...(id ? { id } : {}),
+        ...(version ? { version } : {}),
+    };
+};
+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 "";
+    const entry = catalogById[ref.id];
+    return entry?.label || ref.id;
+};
+export function usePromptPackSelection({ mode, catalog, envSelection = null, overrideSelection = null, locked = false, workspaceSession = null, setWorkspaceSession, }) {
+    const catalogById = useMemo(() => Object.fromEntries(catalog.map((entry) => [entry.id, entry])), [catalog]);
+    const sessionSelection = useMemo(() => normalizePromptPackRef(workspaceSession?.promptPackSelectionByMode?.[mode]), [mode, workspaceSession]);
+    const validSessionSelection = useMemo(() => {
+        if (!sessionSelection?.id)
+            return sessionSelection;
+        if (catalog.length === 0)
+            return undefined;
+        return catalogById[sessionSelection.id] ? sessionSelection : undefined;
+    }, [catalog.length, catalogById, sessionSelection]);
+    const mergedSelection = useMemo(() => mergeRef(envSelection ?? undefined, mergeRef(overrideSelection ?? undefined, locked ? undefined : validSessionSelection)), [envSelection, locked, overrideSelection, validSessionSelection]);
+    const activeLabel = useMemo(() => formatLabel(mergedSelection, catalogById), [catalogById, mergedSelection]);
+    const setSelection = useCallback((packId) => {
+        if (!setWorkspaceSession || locked)
+            return;
+        const trimmedPackId = packId.trim();
+        const nextCatalogEntry = trimmedPackId ? catalogById[trimmedPackId] : undefined;
+        const nextVersion = nextCatalogEntry?.version || undefined;
+        setWorkspaceSession((session) => ({
+            ...session,
+            promptPackSelectionByMode: {
+                ...session.promptPackSelectionByMode,
+                [mode]: trimmedPackId
+                    ? {
+                        id: trimmedPackId,
+                        ...(nextVersion ? { version: nextVersion } : {}),
+                    }
+                    : null,
+            },
+        }));
+    }, [catalogById, locked, mode, setWorkspaceSession]);
+    const resetSelection = useCallback(() => {
+        if (!setWorkspaceSession || locked)
+            return;
+        setWorkspaceSession((session) => ({
+            ...session,
+            promptPackSelectionByMode: {
+                ...session.promptPackSelectionByMode,
+                [mode]: null,
+            },
+        }));
+    }, [locked, mode, setWorkspaceSession]);
+    return {
+        activeRef: mergedSelection,
+        activeLabel,
+        catalogById,
+        setSelection,
+        resetSelection,
+        mergedSelection,
+    };
+}

package/dist/useRightRailTabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRightRailTabs.d.ts","sourceRoot":"","sources":["../src/useRightRailTabs.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,UAAU,GACX,EAAE,uBAAuB,GAAG,kBAAkB,CA0B9C"}
+{"version":3,"file":"useRightRailTabs.d.ts","sourceRoot":"","sources":["../src/useRightRailTabs.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEnG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,CAAC;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAIF,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,UAAU,GACX,EAAE,uBAAuB,GAAG,kBAAkB,CA0B9C"}

package/dist/useRightRailTabs.js

@@ -1,13 +1,14 @@
 import { useEffect, useMemo, useState } from "react";
 import { resolveRightRailTabsForMode } from "@treasuryspatial/mode-policy";
+const labelFromTabId = (id) => id.replace(/[-_]+/g, " ");
 export function useRightRailTabs({ mode, modePolicy, baseTabs, defaultTab, }) {
     const tabs = useMemo(() => {
         const fallbackTabs = baseTabs.map((tab) => tab.id);
         const resolvedTabs = resolveRightRailTabsForMode(mode, modePolicy, fallbackTabs);
-        const selected = new Set(resolvedTabs);
-        return baseTabs.filter((tab) => selected.has(tab.id));
+        const tabById = new Map(baseTabs.map((tab) => [tab.id, tab]));
+        return resolvedTabs.map((id) => tabById.get(id) ?? { id, label: labelFromTabId(id) });
     }, [baseTabs, mode, modePolicy]);
-    const modeDefaultTab = useMemo(() => tabs[0]?.id ?? defaultTab ?? "images", [defaultTab, tabs]);
+    const modeDefaultTab = useMemo(() => tabs[0]?.id ?? defaultTab ?? "feed", [defaultTab, tabs]);
     const [activeTab, setActiveTab] = useState(() => modeDefaultTab);
     useEffect(() => {
         if (activeTab && tabs.some((tab) => tab.id === activeTab))

package/dist/useSessionLogout.d.ts.map

@@ -1 +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,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,EAC/B,WAAgC,EAChC,YAAuB,EACvB,UAAU,EACV,UAAU,GACX,GAAE,uBAA4B,GAAG,oBAAoB,CAgBrD"}
+{"version":3,"file":"useSessionLogout.d.ts","sourceRoot":"","sources":["../src/useSessionLogout.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAI5E,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,MAAM,MAAM,oBAAoB,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,EAC/B,WAAgC,EAChC,YAAuB,EACvB,UAAU,EACV,UAAU,GACX,GAAE,uBAA4B,GAAG,oBAAoB,CAyBrD"}

package/dist/useSessionLogout.js

@@ -1,9 +1,20 @@
 import { useCallback } from "react";
 import { clearSessionCookies } from "./sessionAuth";
+const TELEMETRY_SESSION_STORAGE_KEY = "telemetry:session-id";
 export function useSessionLogout({ logoutRoute = "/api/auth/logout", redirectPath = "/login", cookieKeys, onRedirect, } = {}) {
     return useCallback(async () => {
         try {
-            await fetch(logoutRoute, { method: "POST" });
+            let sessionId = "";
+            try {
+                sessionId = window.sessionStorage.getItem(TELEMETRY_SESSION_STORAGE_KEY) || "";
+            }
+            catch {
+                sessionId = "";
+            }
+            await fetch(logoutRoute, {
+                method: "POST",
+                headers: sessionId ? { "x-session-id": sessionId } : undefined,
+            });
         }
         catch {
             // ignore logout sync failures

package/dist/useSessionRevocationPing.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"useSessionRevocationPing.d.ts","sourceRoot":"","sources":["../src/useSessionRevocationPing.ts"],"names":[],"mappings":"AAIA,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,QAsCjC"}

package/dist/useSessionRevocationPing.js

@@ -1,16 +1,29 @@
 import { useEffect } from "react";
+const TELEMETRY_SESSION_STORAGE_KEY = "telemetry:session-id";
 export function useSessionRevocationPing({ enabled, pingRoute = "/api/auth/session/ping", intervalMs = 60_000, onRevoked, }) {
     useEffect(() => {
         if (!enabled)
             return;
         let active = true;
+        const resolveTelemetrySessionId = () => {
+            try {
+                return window.sessionStorage.getItem(TELEMETRY_SESSION_STORAGE_KEY) || "";
+            }
+            catch {
+                return "";
+            }
+        };
         const ping = async () => {
             try {
-                const response = await fetch(pingRoute, { method: "POST" });
+                const sessionId = resolveTelemetrySessionId();
+                const response = await fetch(pingRoute, {
+                    method: "POST",
+                    headers: sessionId ? { "x-session-id": sessionId } : undefined,
+                });
                 const data = await response.json().catch(() => null);
                 if (!active)
                     return;
-                if (data?.revoked) {
+                if (data?.revoked || response.status === 401) {
                     onRevoked?.();
                 }
             }

package/dist/useShellPanelToggle.d.ts

@@ -1,12 +1,18 @@
+export declare const PANEL_COLLAPSE_BODY_CLASS = "panels-collapsed";
+export declare const PANEL_COLLAPSE_EVENT = "treasury:panels-toggle";
+export declare const NAV_COLLAPSE_BODY_CLASS = "nav-collapsed";
+export declare const NAV_COLLAPSE_EVENT = "treasury:nav-toggle";
 export type UseShellPanelToggleOptions = {
     enabled?: boolean;
     bodyClassName?: string;
     eventName?: string;
+    navBodyClassName?: string;
+    navEventName?: string;
 };
 export type ShellPanelToggleState = {
     collapsed: boolean;
     toggle: () => void;
     setCollapsed: (next: boolean) => void;
 };
-export declare function useShellPanelToggle({ enabled, bodyClassName, eventName, }?: UseShellPanelToggleOptions): ShellPanelToggleState;
+export declare function useShellPanelToggle({ enabled, bodyClassName, eventName, navBodyClassName, navEventName, }?: UseShellPanelToggleOptions): ShellPanelToggleState;
 //# sourceMappingURL=useShellPanelToggle.d.ts.map

package/dist/useShellPanelToggle.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"useShellPanelToggle.d.ts","sourceRoot":"","sources":["../src/useShellPanelToggle.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,yBAAyB,qBAAqB,CAAC;AAC5D,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAC7D,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAExD,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,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,aAAyC,EACzC,SAAgC,EAChC,gBAA0C,EAC1C,YAAiC,GAClC,GAAE,0BAA+B,GAAG,qBAAqB,CAiDzD"}

package/dist/useShellPanelToggle.js

@@ -1,15 +1,21 @@
 import { useCallback, useEffect, useState } from "react";
-export function useShellPanelToggle({ enabled = true, bodyClassName = "nav-collapsed", eventName = "treasury:nav-toggle", } = {}) {
+export const PANEL_COLLAPSE_BODY_CLASS = "panels-collapsed";
+export const PANEL_COLLAPSE_EVENT = "treasury:panels-toggle";
+export const NAV_COLLAPSE_BODY_CLASS = "nav-collapsed";
+export const NAV_COLLAPSE_EVENT = "treasury:nav-toggle";
+export function useShellPanelToggle({ enabled = true, bodyClassName = PANEL_COLLAPSE_BODY_CLASS, eventName = PANEL_COLLAPSE_EVENT, navBodyClassName = NAV_COLLAPSE_BODY_CLASS, navEventName = NAV_COLLAPSE_EVENT, } = {}) {
     const [collapsed, setCollapsedState] = useState(false);
     const setCollapsed = useCallback((next) => {
         setCollapsedState(next);
         if (typeof document !== "undefined") {
             document.body.classList.toggle(bodyClassName, next);
+            document.body.classList.toggle(navBodyClassName, next);
         }
         if (typeof window !== "undefined") {
-            window.dispatchEvent(new CustomEvent(eventName, { detail: { hidden: next } }));
+            window.dispatchEvent(new CustomEvent(eventName, { detail: { collapsed: next } }));
+            window.dispatchEvent(new CustomEvent(navEventName, { detail: { hidden: next, collapsed: next } }));
         }
-    }, [bodyClassName, eventName]);
+    }, [bodyClassName, eventName, navBodyClassName, navEventName]);
     useEffect(() => {
         if (!enabled) {
             setCollapsed(false);
@@ -17,16 +23,18 @@ export function useShellPanelToggle({ enabled = true, bodyClassName = "nav-colla
         }
         if (typeof document === "undefined" || typeof window === "undefined")
             return;
-        setCollapsedState(document.body.classList.contains(bodyClassName));
+        setCollapsedState(document.body.classList.contains(bodyClassName) || document.body.classList.contains(navBodyClassName));
         const handleToggle = (event) => {
             const detail = event.detail;
-            setCollapsedState(Boolean(detail?.hidden));
+            setCollapsedState(Boolean(detail?.collapsed ?? detail?.hidden));
         };
         window.addEventListener(eventName, handleToggle);
+        window.addEventListener(navEventName, handleToggle);
         return () => {
             window.removeEventListener(eventName, handleToggle);
+            window.removeEventListener(navEventName, handleToggle);
         };
-    }, [bodyClassName, enabled, eventName, setCollapsed]);
+    }, [bodyClassName, enabled, eventName, navBodyClassName, navEventName, setCollapsed]);
     const toggle = useCallback(() => {
         if (!enabled)
             return;

package/dist/workspaceSession.d.ts

@@ -0,0 +1,36 @@
+import type { PromptPackRef } from "@treasuryspatial/render-kit";
+export declare const WORKSPACE_SESSION_SCHEMA_VERSION = "2026-05-08";
+export type ComposerWorkspaceUiState = {
+    primaryTabByMode: Record<string, string>;
+    promptKitOpenByMode: Record<string, boolean>;
+    moduleKitOpenByMode: Record<string, boolean>;
+    activeImaginePresetIdByMode: Record<string, string | null>;
+    autoGenerateEnabledByMode: Record<string, boolean>;
+    controlPanelOpenByMode: Record<string, boolean>;
+    rightPanelOpenByMode: Record<string, boolean>;
+    rightPanelTabByMode: Record<string, string>;
+};
+export type ComposerWorkspaceSession<TDraft> = {
+    schemaVersion: string;
+    workspaceSessionId?: string;
+    label?: string;
+    activeMode: string;
+    uiState: ComposerWorkspaceUiState;
+    modeDraftState: Record<string, TDraft>;
+    promptPackSelectionByMode: Record<string, PromptPackRef | null>;
+    renderStateByMode: Record<string, unknown>;
+    updatedAt?: string;
+};
+export type ComposerWorkspaceSessionUpdater<TDraft> = (session: ComposerWorkspaceSession<TDraft>) => ComposerWorkspaceSession<TDraft>;
+export declare const createEmptyComposerWorkspaceUiState: () => ComposerWorkspaceUiState;
+export declare const createEmptyComposerWorkspaceSession: <TDraft>(createDraft: () => TDraft, options?: {
+    activeMode?: string;
+    modeIds?: string[];
+}) => ComposerWorkspaceSession<TDraft>;
+export declare const restoreComposerWorkspaceSession: <TDraft>(raw: unknown, options: {
+    createDraft: () => TDraft;
+    restoreDraft: (rawDraft: unknown) => TDraft;
+    activeMode?: string;
+    modeIds?: string[];
+}) => ComposerWorkspaceSession<TDraft>;
+//# sourceMappingURL=workspaceSession.d.ts.map

package/dist/workspaceSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceSession.d.ts","sourceRoot":"","sources":["../src/workspaceSession.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,eAAO,MAAM,gCAAgC,eAAe,CAAC;AAE7D,MAAM,MAAM,wBAAwB,GAAG;IACrC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnD,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,MAAM,IAAI;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,wBAAwB,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC;IAChE,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,+BAA+B,CAAC,MAAM,IAAI,CACpD,OAAO,EAAE,wBAAwB,CAAC,MAAM,CAAC,KACtC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAiFtC,eAAO,MAAM,mCAAmC,QAAO,wBASrD,CAAC;AAEH,eAAO,MAAM,mCAAmC,GAAI,MAAM,EACxD,aAAa,MAAM,MAAM,EACzB,UAAS;IACP,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACf,KACL,wBAAwB,CAAC,MAAM,CAejC,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,MAAM,EACpD,KAAK,OAAO,EACZ,SAAS;IACP,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,KACA,wBAAwB,CAAC,MAAM,CAyDjC,CAAC"}

package/dist/workspaceSession.js

@@ -0,0 +1,141 @@
+export const WORKSPACE_SESSION_SCHEMA_VERSION = "2026-05-08";
+const asRecord = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+const normalizeStringRecord = (value) => {
+    const record = asRecord(value);
+    if (!record)
+        return {};
+    return Object.fromEntries(Object.entries(record).filter(([, entry]) => typeof entry === "string" && entry.length > 0));
+};
+const normalizeBooleanRecord = (value) => {
+    const record = asRecord(value);
+    if (!record)
+        return {};
+    return Object.fromEntries(Object.entries(record).filter(([, entry]) => typeof entry === "boolean"));
+};
+const normalizeNullableStringRecord = (value) => {
+    const record = asRecord(value);
+    if (!record)
+        return {};
+    return Object.fromEntries(Object.entries(record).filter(([, entry]) => typeof entry === "string" || entry === null));
+};
+const normalizeUnknownRecord = (value) => {
+    const record = asRecord(value);
+    if (!record)
+        return {};
+    return Object.fromEntries(Object.entries(record));
+};
+const isInlineDataUrl = (value) => typeof value === "string" && /^data:[^;]+;base64,/i.test(value);
+const stripInlineDataUrls = (value) => {
+    if (isInlineDataUrl(value))
+        return null;
+    if (Array.isArray(value))
+        return value.map(stripInlineDataUrls);
+    const record = asRecord(value);
+    if (!record)
+        return value;
+    return Object.fromEntries(Object.entries(record).map(([key, entry]) => [key, stripInlineDataUrls(entry)]));
+};
+const normalizeRenderStateRecord = (value) => {
+    const record = normalizeUnknownRecord(value);
+    return Object.fromEntries(Object.entries(record).map(([modeId, entry]) => [modeId, stripInlineDataUrls(entry)]));
+};
+const trimOptional = (value) => {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+};
+const normalizePromptPackRef = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const id = trimOptional(value.id);
+    const version = trimOptional(value.version);
+    if (!id && !version)
+        return null;
+    return {
+        ...(id ? { id } : {}),
+        ...(version ? { version } : {}),
+    };
+};
+const normalizePromptPackRecord = (value) => {
+    const record = asRecord(value);
+    if (!record)
+        return {};
+    return Object.fromEntries(Object.entries(record)
+        .map(([modeId, entry]) => [modeId, normalizePromptPackRef(entry)])
+        .filter(([, entry]) => entry !== null));
+};
+export const createEmptyComposerWorkspaceUiState = () => ({
+    primaryTabByMode: {},
+    promptKitOpenByMode: {},
+    moduleKitOpenByMode: {},
+    activeImaginePresetIdByMode: {},
+    autoGenerateEnabledByMode: {},
+    controlPanelOpenByMode: {},
+    rightPanelOpenByMode: {},
+    rightPanelTabByMode: {},
+});
+export const createEmptyComposerWorkspaceSession = (createDraft, options = {}) => {
+    const activeMode = options.activeMode || "imagine";
+    const normalizedModeIds = Array.from(new Set([activeMode, ...(options.modeIds ?? [])])).filter(Boolean);
+    const modeDraftState = normalizedModeIds.reduce((acc, modeId) => {
+        acc[modeId] = createDraft();
+        return acc;
+    }, {});
+    return {
+        schemaVersion: WORKSPACE_SESSION_SCHEMA_VERSION,
+        activeMode,
+        uiState: createEmptyComposerWorkspaceUiState(),
+        modeDraftState,
+        promptPackSelectionByMode: {},
+        renderStateByMode: {},
+    };
+};
+export const restoreComposerWorkspaceSession = (raw, options) => {
+    const fallback = createEmptyComposerWorkspaceSession(options.createDraft, {
+        activeMode: options.activeMode,
+        modeIds: options.modeIds,
+    });
+    const record = asRecord(raw);
+    if (!record)
+        return fallback;
+    const rawUiState = asRecord(record.uiState);
+    const rawDraftState = asRecord(record.modeDraftState);
+    const rawPromptPackState = asRecord(record.promptPackSelectionByMode);
+    const rawRenderState = asRecord(record.renderStateByMode);
+    const normalizedModeIds = Array.from(new Set([
+        fallback.activeMode,
+        ...(options.modeIds ?? []),
+        ...Object.keys(rawDraftState ?? {}),
+        ...Object.keys(rawPromptPackState ?? {}),
+        ...Object.keys(rawRenderState ?? {}),
+    ])).filter(Boolean);
+    const modeDraftState = normalizedModeIds.reduce((acc, modeId) => {
+        acc[modeId] = options.restoreDraft(rawDraftState?.[modeId]);
+        return acc;
+    }, {});
+    return {
+        schemaVersion: typeof record.schemaVersion === "string" && record.schemaVersion.trim().length > 0
+            ? record.schemaVersion
+            : fallback.schemaVersion,
+        workspaceSessionId: typeof record.workspaceSessionId === "string" && record.workspaceSessionId.trim().length > 0
+            ? record.workspaceSessionId
+            : undefined,
+        label: typeof record.label === "string" && record.label.trim().length > 0 ? record.label : undefined,
+        activeMode: typeof record.activeMode === "string" && record.activeMode.trim().length > 0
+            ? record.activeMode
+            : fallback.activeMode,
+        uiState: {
+            primaryTabByMode: normalizeStringRecord(rawUiState?.primaryTabByMode),
+            promptKitOpenByMode: normalizeBooleanRecord(rawUiState?.promptKitOpenByMode),
+            moduleKitOpenByMode: normalizeBooleanRecord(rawUiState?.moduleKitOpenByMode),
+            activeImaginePresetIdByMode: normalizeNullableStringRecord(rawUiState?.activeImaginePresetIdByMode),
+            autoGenerateEnabledByMode: normalizeBooleanRecord(rawUiState?.autoGenerateEnabledByMode),
+            controlPanelOpenByMode: normalizeBooleanRecord(rawUiState?.controlPanelOpenByMode),
+            rightPanelOpenByMode: normalizeBooleanRecord(rawUiState?.rightPanelOpenByMode),
+            rightPanelTabByMode: normalizeStringRecord(rawUiState?.rightPanelTabByMode),
+        },
+        modeDraftState,
+        promptPackSelectionByMode: normalizePromptPackRecord(rawPromptPackState),
+        renderStateByMode: normalizeRenderStateRecord(rawRenderState),
+        updatedAt: typeof record.updatedAt === "string" && record.updatedAt.trim().length > 0 ? record.updatedAt : undefined,
+    };
+};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@treasuryspatial/viewer-react",
-  "version": "0.1.44",
+  "version": "0.1.48",
   "type": "module",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
@@ -18,12 +19,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@treasuryspatial/mode-policy": "^0.1.5",
-    "@treasuryspatial/panel-core": "^0.1.5",
-    "@treasuryspatial/plugin-manifest": "^0.1.3",
-    "@treasuryspatial/render-kit": "^0.1.17",
-    "@treasuryspatial/surface-kit": "^0.1.6",
-    "@treasuryspatial/viewer-kit": "^0.2.31"
+    "@treasuryspatial/mode-policy": "^0.1.7",
+    "@treasuryspatial/panel-core": "^0.1.14",
+    "@treasuryspatial/plugin-manifest": "^0.1.13",
+    "@treasuryspatial/render-kit": "^0.1.23",
+    "@treasuryspatial/surface-kit": "^0.1.16",
+    "@treasuryspatial/viewer-kit": "^0.2.54"
   },
   "peerDependencies": {
     "react": ">=18"

package/dist/usePromptPackSelectionByMode.d.ts

@@ -1,26 +0,0 @@
-import { type PromptPackCatalogEntry, type PromptPackRef } from "@treasuryspatial/render-kit";
-export type PromptPackMode = string;
-export type PromptPackSelectionByMode = Partial<Record<PromptPackMode, PromptPackRef>>;
-export type UsePromptPackSelectionByModeOptions = {
-    mode: PromptPackMode;
-    modes?: 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 DEFAULT_PROMPT_PACK_MODES: PromptPackMode[];
-export declare const PROMPT_PACK_MODES: string[];
-export declare function usePromptPackSelectionByMode({ mode, modes, 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

@@ -1 +0,0 @@
-{"version":3,"file":"usePromptPackSelectionByMode.d.ts","sourceRoot":"","sources":["../src/usePromptPackSelectionByMode.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,sBAAsB,EAE3B,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,MAAM,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;AAEvF,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,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,yBAAyB,EAAE,cAAc,EAAO,CAAC;AAC9D,eAAO,MAAM,iBAAiB,UAA4B,CAAC;AAiC3D,wBAAgB,4BAA4B,CAAC,EAC3C,IAAI,EACJ,KAAiC,EACjC,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,CA0FA"}