@warkypublic/svelix 0.1.31 → 0.1.33

package/dist/components/GlobalStateStore/GlobalStateStore.d.ts

@@ -6,6 +6,7 @@ type GlobalStateStoreApi = {
     setState: (partial: PartialUpdater, replace?: boolean) => void;
     subscribe: (run: (value: GlobalStateStoreType) => void) => () => void;
 };
+declare const createGlobalStateStore: () => GlobalStateStoreApi;
 declare const GlobalStateStore: GlobalStateStoreApi;
 declare const languageStore: Readable<SupportedLanguage>;
 declare function useGlobalStateStore(): Readable<GlobalStateStoreType>;
@@ -18,4 +19,4 @@ declare const setAuthToken: (token: string) => void;
 declare const GetGlobalState: () => GlobalStateStoreType;
 declare const setLanguage: (lang: SupportedLanguage) => void;
 export type { GlobalStateStoreApi };
-export { getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, languageStore, setApiURL, setAuthToken, setLanguage, useGlobalStateStore, };
+export { createGlobalStateStore, getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, languageStore, setApiURL, setAuthToken, setLanguage, useGlobalStateStore, };

package/dist/components/GlobalStateStore/GlobalStateStore.js

@@ -30,6 +30,7 @@ const createInitialState = () => ({
         connected: true,
         loading: false,
         loggedIn: false,
+        validated: true,
     },
     user: {
         guid: "",
@@ -45,6 +46,62 @@ const toPersistedState = (state) => ({
     session: state.session,
     user: state.user,
 });
+const isSessionExpired = (session) => {
+    if (!session?.expiryDate) {
+        return false;
+    }
+    return new Date(session.expiryDate) < new Date();
+};
+const hasSessionCredentials = (session) => {
+    return Boolean(session?.authToken || session?.loggedIn);
+};
+const createClearedAuthenticatedState = (state, options) => {
+    const initialState = createInitialState();
+    return {
+        owner: initialState.owner,
+        program: initialState.program,
+        session: {
+            ...initialState.session,
+            apiURL: state.session.apiURL,
+            connected: options?.connected ?? true,
+            error: options?.error,
+            loading: options?.loading ?? false,
+            validated: true,
+        },
+        user: {
+            ...initialState.user,
+            language: state.user.language ?? initialState.user.language,
+        },
+    };
+};
+const getSessionValidationMismatch = ({ fetchedSession, fetchedUser, previousState, }) => {
+    const previousAuthToken = previousState.session.authToken ?? "";
+    const previousGuid = previousState.user.guid ?? "";
+    const previousUsername = previousState.user.username ?? "";
+    if (fetchedSession?.loggedIn === false) {
+        return true;
+    }
+    if (previousAuthToken &&
+        fetchedSession?.authToken &&
+        fetchedSession.authToken !== previousAuthToken) {
+        return true;
+    }
+    if (previousGuid && fetchedUser?.guid && fetchedUser.guid !== previousGuid) {
+        return true;
+    }
+    if (previousUsername &&
+        fetchedUser?.username &&
+        fetchedUser.username !== previousUsername) {
+        return true;
+    }
+    return false;
+};
+const hasSessionValidationSignal = (session, user) => {
+    return Boolean(session?.loggedIn === true ||
+        session?.authToken ||
+        user?.guid ||
+        user?.username);
+};
 const createGlobalStateStore = () => {
     const initialState = createInitialState();
     let isStorageInitialized = false;
@@ -96,6 +153,58 @@ const createGlobalStateStore = () => {
         try {
             const currentState = getState();
             const result = await currentState.onFetchSession?.(currentState);
+            const hasExistingSession = hasSessionCredentials(currentState.session);
+            const nextUser = { ...currentState.user, ...result?.user };
+            const nextSession = {
+                ...currentState.session,
+                ...result?.session,
+                apiURL: url || currentState.session.apiURL,
+                connected: true,
+                loading: false,
+            };
+            const serverConfirmsSession = result?.session?.loggedIn === true || Boolean(result?.session?.authToken);
+            const serverConfirmsUser = Boolean(result?.user?.guid || result?.user?.username);
+            const alreadyValidated = currentState.session.validated === true;
+            const requiresValidation = (hasExistingSession && !alreadyValidated) || serverConfirmsSession;
+            const hasValidationSignal = serverConfirmsSession || serverConfirmsUser || alreadyValidated;
+            const hasValidationMismatch = getSessionValidationMismatch({
+                fetchedSession: result?.session,
+                fetchedUser: result?.user,
+                previousState: currentState,
+            });
+            const resolvedLoggedIn = result?.session?.loggedIn ??
+                (hasValidationSignal && Boolean(nextSession.authToken));
+            const resolvedSession = {
+                ...nextSession,
+                loggedIn: resolvedLoggedIn,
+                validated: !requiresValidation || hasValidationSignal,
+            };
+            const isInvalidSession = hasValidationMismatch ||
+                isSessionExpired(resolvedSession) ||
+                (requiresValidation &&
+                    hasValidationSignal &&
+                    (!resolvedSession.loggedIn || !resolvedSession.authToken));
+            if (isInvalidSession) {
+                const clearedState = createClearedAuthenticatedState(currentState);
+                setGlobalState((state) => ({
+                    ...state,
+                    ...result,
+                    layout: { ...state.layout, ...result?.layout },
+                    navigation: { ...state.navigation, ...result?.navigation },
+                    owner: { ...clearedState.owner, ...result?.owner },
+                    program: {
+                        ...clearedState.program,
+                        ...result?.program,
+                        updatedAt: new Date().toISOString(),
+                    },
+                    session: {
+                        ...clearedState.session,
+                        apiURL: url || state.session.apiURL,
+                    },
+                    user: clearedState.user,
+                }));
+                return;
+            }
             setGlobalState((state) => ({
                 ...state,
                 ...result,
@@ -107,21 +216,17 @@ const createGlobalStateStore = () => {
                     ...result?.program,
                     updatedAt: new Date().toISOString(),
                 },
-                session: {
-                    ...state.session,
-                    ...result?.session,
-                    connected: true,
-                    loading: false,
-                },
-                user: { ...state.user, ...result?.user },
+                session: resolvedSession,
+                user: nextUser,
             }));
         }
         catch (e) {
+            const error = `Load Exception: ${String(e)}`;
             setGlobalState((state) => ({
                 session: {
                     ...state.session,
                     connected: false,
-                    error: `Load Exception: ${String(e)}`,
+                    error,
                     loading: false,
                 },
             }));
@@ -134,10 +239,10 @@ const createGlobalStateStore = () => {
         },
         isLoggedIn: () => {
             const session = getState().session;
-            if (!session.loggedIn || !session.authToken) {
+            if (!session.validated || !session.loggedIn || !session.authToken) {
                 return false;
             }
-            if (session.expiryDate && new Date(session.expiryDate) < new Date()) {
+            if (isSessionExpired(session)) {
                 return false;
             }
             return true;
@@ -152,7 +257,8 @@ const createGlobalStateStore = () => {
                             authToken: authToken ?? "",
                             expiryDate: new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString(),
                             loading: true,
-                            loggedIn: true,
+                            loggedIn: false,
+                            validated: false,
                         },
                         user: {
                             ...state.user,
@@ -162,6 +268,7 @@ const createGlobalStateStore = () => {
                     const currentState = getState();
                     const result = await currentState.onLogin?.(currentState);
                     if (result) {
+                        const loginValidated = hasSessionValidationSignal(result.session, result.user);
                         setGlobalState((state) => ({
                             owner: result.owner
                                 ? { ...state.owner, ...result.owner }
@@ -169,9 +276,13 @@ const createGlobalStateStore = () => {
                             program: result.program
                                 ? { ...state.program, ...result.program }
                                 : state.program,
-                            session: result.session
-                                ? { ...state.session, ...result.session }
-                                : state.session,
+                            session: {
+                                ...state.session,
+                                ...result.session,
+                                loggedIn: result.session?.loggedIn ??
+                                    (loginValidated && Boolean(result.session?.authToken ?? state.session.authToken)),
+                                validated: loginValidated ? true : state.session.validated,
+                            },
                             user: result.user
                                 ? { ...state.user, ...result.user }
                                 : state.user,
@@ -180,14 +291,14 @@ const createGlobalStateStore = () => {
                     await fetchDataInternal();
                 }
                 catch (e) {
+                    const currentState = getState();
+                    const clearedState = createClearedAuthenticatedState(currentState, {
+                        connected: false,
+                        error: `Login Exception: ${String(e)}`,
+                    });
                     setGlobalState((state) => ({
-                        session: {
-                            ...state.session,
-                            connected: false,
-                            error: `Login Exception: ${String(e)}`,
-                            loading: false,
-                            loggedIn: false,
-                        },
+                        ...state,
+                        ...clearedState,
                     }));
                 }
                 finally {
@@ -203,6 +314,7 @@ const createGlobalStateStore = () => {
         logout: async () => {
             await waitForInitialization();
             return withOperationLock(async () => {
+                const previousState = getState();
                 try {
                     setGlobalState((state) => ({
                         ...createInitialState(),
@@ -215,7 +327,7 @@ const createGlobalStateStore = () => {
                         },
                     }));
                     const currentState = getState();
-                    const result = await currentState.onLogout?.(currentState);
+                    const result = await currentState.onLogout?.(previousState);
                     if (result) {
                         setGlobalState((state) => ({
                             owner: result.owner
@@ -235,13 +347,14 @@ const createGlobalStateStore = () => {
                     await fetchDataInternal();
                 }
                 catch (e) {
+                    const currentState = getState();
+                    const clearedState = createClearedAuthenticatedState(currentState, {
+                        connected: false,
+                        error: `Logout Exception: ${String(e)}`,
+                    });
                     setGlobalState((state) => ({
-                        session: {
-                            ...state.session,
-                            connected: false,
-                            error: `Logout Exception: ${String(e)}`,
-                            loading: false,
-                        },
+                        ...state,
+                        ...clearedState,
                     }));
                 }
                 finally {
@@ -319,6 +432,7 @@ const createGlobalStateStore = () => {
     store.set(initialStoreState);
     initializationPromise = loadStorage()
         .then((loadedState) => {
+        const hasPersistedSession = hasSessionCredentials(loadedState.session);
         setGlobalState((current) => ({
             ...current,
             ...loadedState,
@@ -328,6 +442,12 @@ const createGlobalStateStore = () => {
                 ...loadedState.session,
                 connected: true,
                 loading: false,
+                loggedIn: hasPersistedSession
+                    ? false
+                    : loadedState.session?.loggedIn ?? current.session.loggedIn,
+                validated: hasPersistedSession
+                    ? false
+                    : loadedState.session?.validated ?? current.session.validated,
             },
         }));
     })
@@ -386,4 +506,4 @@ const GetGlobalState = () => {
 const setLanguage = (lang) => {
     GlobalStateStore.getState().setLanguage(lang);
 };
-export { getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, languageStore, setApiURL, setAuthToken, setLanguage, useGlobalStateStore, };
+export { createGlobalStateStore, getApiURL, getAuthToken, GetGlobalState, GlobalStateStore, isLoggedIn, languageStore, setApiURL, setAuthToken, setLanguage, useGlobalStateStore, };

package/dist/components/GlobalStateStore/GlobalStateStore.types.d.ts

@@ -107,6 +107,7 @@ interface SessionState {
     loggedIn?: boolean;
     meta?: Record<string, any>;
     parameters?: Record<string, any>;
+    validated?: boolean;
 }
 type SupportedLanguage = 'af' | 'en';
 interface ThemeSettings {

package/dist/components/GlobalStateStore/GlobalStateStore.utils.js

@@ -3,7 +3,8 @@ const SKIP_PATHS = new Set([
     'app.controls',
     'session.connected',
     'session.error',
-    'session.loading'
+    'session.loading',
+    'session.validated'
 ]);
 const PERSIST_KEYS = [
     'layout',

package/dist/components/Gridler/components/Gridler.svelte

@@ -28,6 +28,8 @@
       item?: Record<string, unknown>;
       column?: GridlerColumn;
     }) => void;
+    onRowClick?: (row: number) => void;
+    onRowContextMenu?: (row: number) => void;
     /** Resolve raw row data by row index for populating onCellEvent. */
     getRowData?: (row: number) => Record<string, unknown> | undefined;
     children?: Snippet;
@@ -59,6 +61,8 @@
     onHeaderContextMenu,
     onMenuClick,
     onGridMenuOpen,
+    onRowClick,
+    onRowContextMenu,
     theme = {},
     selection = { type: "none" } as Selection,
     onSelectionChange,
@@ -434,6 +438,9 @@
     onCellEvent?.("dblclick", getRowData?.(item[1]) ?? {}, columns[item[0]] ?? { id: "", title: "" });
     onGridEvent?.("dblclick", getRowData?.(item[1]) ?? {}, columns[item[0]] ?? { id: "", title: "" });
   }}
+  onRowClick={(row) => {
+    onRowClick?.(row);
+  }}
   onCellClick={(item) => {
     onCellEvent?.("click", getRowData?.(item[1]) ?? {}, columns[item[0]] ?? { id: "", title: "" });
     onGridEvent?.("click", getRowData?.(item[1]) ?? {}, columns[item[0]] ?? { id: "", title: "" });
@@ -450,6 +457,9 @@
     onCellEvent?.("contextmenu", getRowData?.(item[1]) ?? {}, columns[item[0]] ?? { id: "", title: "" }, { x, y });
     onGridEvent?.("contextmenu", getRowData?.(item[1]) ?? {}, columns[item[0]] ?? { id: "", title: "" }, { x, y });
   }}
+  onRowContextMenu={(row) => {
+    onRowContextMenu?.(row);
+  }}
   onColumnResized={(col, width) => {
     onGridEvent?.("column_resized", undefined, columns[col], undefined, { width });
   }}

package/dist/components/Gridler/components/Gridler.svelte.d.ts

@@ -13,6 +13,8 @@ export interface Props extends Partial<GridlerProps> {
         item?: Record<string, unknown>;
         column?: GridlerColumn;
     }) => void;
+    onRowClick?: (row: number) => void;
+    onRowContextMenu?: (row: number) => void;
     /** Resolve raw row data by row index for populating onCellEvent. */
     getRowData?: (row: number) => Record<string, unknown> | undefined;
     children?: Snippet;

package/dist/components/Gridler/components/GridlerCanvas.svelte

@@ -56,6 +56,8 @@
     onVisibleRangeChange?: (range: VisibleRange) => void;
     onSelectionChange?: (sel: Selection) => void;
     onCellDblClick?: (item: Item, cell: GridlerCell) => void;
+    onRowClick?: (row: number) => void;
+    onRowContextMenu?: (row: number) => void;
     onColumnMoved?: (from: number, to: number) => void;
     onCellEdited?: (item: Item, cell: GridlerCell) => void;
     onDelete?: (sel: Selection) => void;
@@ -107,6 +109,8 @@
     onVisibleRangeChange,
     onSelectionChange,
     onCellDblClick,
+    onRowClick,
+    onRowContextMenu,
     onColumnMoved,
     onCellEdited: _onCellEdited,
     onDelete: _onDelete,
@@ -484,7 +488,7 @@
   // ── Header context menu ───────────────────────────────────────────────────────
 
   function handleContextMenu(e: MouseEvent) {
-    if (e.offsetX < rowMarkerWidth) return;
+    if (e.offsetY < headerHeight && e.offsetX < rowMarkerWidth) return;
     const fixedBoundaryX =
       fixedColumns > 0
         ? getColumnX(effectiveColumns, Math.min(fixedColumns, columns.length))
@@ -503,6 +507,14 @@
       return;
     }
 
+    const row = getRowFromOffsetY(e.offsetY);
+    if (row !== null) {
+      e.preventDefault();
+      onRowContextMenu?.(row);
+    }
+
+    if (e.offsetX < rowMarkerWidth) return;
+
     if (onCellContextMenu) {
       const cell = getCellFromPoint(
         localX,
@@ -537,6 +549,12 @@
 
   // ── Mouse handlers ────────────────────────────────────────────────────────────
 
+  function getRowFromOffsetY(offsetY: number): number | null {
+    if (offsetY < headerHeight) return null;
+    const row = Math.floor((offsetY - headerHeight + scrollY) / rowHeight);
+    return row >= 0 && row < rows ? row : null;
+  }
+
   function handleMouseDown(e: MouseEvent) {
     if (e.button !== 0) return;
     pendingGridMenuOpen = false;
@@ -630,6 +648,11 @@
       return;
     }
 
+    const row = getRowFromOffsetY(e.offsetY);
+    if (row !== null) {
+      onRowClick?.(row);
+    }
+
     if (readonly) return;
 
     const cell = getCellFromPoint(
@@ -1055,7 +1078,7 @@
     }
 
     if (rowMarkers !== "none" && offsetX < rowMarkerWidth) {
-      const row = Math.floor((offsetY - headerHeight + scrollY) / rowHeight);
+      const row = getRowFromOffsetY(offsetY);
       if (row >= 0 && row < rows) {
         onRowToggle?.(row);
       }

package/dist/components/Gridler/components/GridlerCanvas.svelte.d.ts

@@ -25,6 +25,8 @@ interface Props {
     onVisibleRangeChange?: (range: VisibleRange) => void;
     onSelectionChange?: (sel: Selection) => void;
     onCellDblClick?: (item: Item, cell: GridlerCell) => void;
+    onRowClick?: (row: number) => void;
+    onRowContextMenu?: (row: number) => void;
     onColumnMoved?: (from: number, to: number) => void;
     onCellEdited?: (item: Item, cell: GridlerCell) => void;
     onDelete?: (sel: Selection) => void;

package/dist/components/Gridler/components/GridlerFull.svelte

@@ -38,6 +38,8 @@
       | "onSearchValueChange"
       | "onVisibleRangeChange"
       | "onCellDblClick"
+      | "onRowClick"
+      | "onRowContextMenu"
     > {
     columns: GridlerColumn[];
 
@@ -81,6 +83,16 @@
       row: number,
       rowData: Record<string, unknown> | undefined,
     ) => void;
+    /** Called on row click with the row index and resolved row data. */
+    onRowClick?: (
+      row: number,
+      rowData: Record<string, unknown> | undefined,
+    ) => void;
+    /** Called on row context-menu with the row index and resolved row data. */
+    onRowContextMenu?: (
+      row: number,
+      rowData: Record<string, unknown> | undefined,
+    ) => void;
 
     // ── Server-side fetching ──────────────────────────────────────────────────
     // Use dataSource + dataSourceOptions (from GridCommonProps) for server config.
@@ -157,6 +169,8 @@
     onCellEdited,
     onCellDblClick,
     onRowDblClick,
+    onRowClick,
+    onRowContextMenu,
     onMenuClick,
     onSelectionChange,
     onCellEvent,
@@ -656,6 +670,14 @@
     onRowDblClick?.(item[1], rowData);
   }
 
+  function handleRowClick(row: number) {
+    onRowClick?.(row, resolveRowData(row));
+  }
+
+  function handleRowContextMenu(row: number) {
+    onRowContextMenu?.(row, resolveRowData(row));
+  }
+
   // ── Selection → selectedItems bridge ──────────────────────────────────────
 
   let internalSelectedItems = $state<Record<string, unknown>[]>([]);
@@ -777,6 +799,8 @@
       onCellEdited?.(item, value);
     }}
     onCellDblClick={handleCellDblClick}
+    onRowClick={handleRowClick}
+    onRowContextMenu={handleRowContextMenu}
     selectedItems={internalSelectedItems}
     getRowData={resolveRowData}
     onSelectionChange={handleSelectionChange}

package/dist/components/Gridler/components/GridlerFull.svelte.d.ts

@@ -1,6 +1,6 @@
 import type { Snippet } from "svelte";
 import type { GridlerCell, GridlerColumn, GridlerContextMenuItem, GridlerProps, Item } from "../types";
-export interface Props extends Omit<Partial<GridlerProps>, "columns" | "rows" | "getCellContent" | "searchValue" | "onSearchValueChange" | "onVisibleRangeChange" | "onCellDblClick"> {
+export interface Props extends Omit<Partial<GridlerProps>, "columns" | "rows" | "getCellContent" | "searchValue" | "onSearchValueChange" | "onVisibleRangeChange" | "onCellDblClick" | "onRowClick" | "onRowContextMenu"> {
     columns: GridlerColumn[];
     /**
      * Optional row data. When provided (and `getCellContent` is omitted), the default
@@ -28,6 +28,10 @@ export interface Props extends Omit<Partial<GridlerProps>, "columns" | "rows" |
     onCellDblClick?: (item: Item, cell: GridlerCell, rowData: Record<string, unknown> | undefined) => void;
     /** Called on row double-click with the row index and resolved row data. */
     onRowDblClick?: (row: number, rowData: Record<string, unknown> | undefined) => void;
+    /** Called on row click with the row index and resolved row data. */
+    onRowClick?: (row: number, rowData: Record<string, unknown> | undefined) => void;
+    /** Called on row context-menu with the row index and resolved row data. */
+    onRowContextMenu?: (row: number, rowData: Record<string, unknown> | undefined) => void;
     /** Rows per cursor-forward page. Defaults to 200. */
     pageSize?: number;
     /**

package/dist/components/Gridler/types.d.ts

@@ -103,6 +103,10 @@ export interface GridlerProps extends GridCommonProps<Record<string, unknown>> {
     onCellEdited?: (item: Item, value: GridlerCell) => void;
     /** Called on cell double-click (low-level; GridlerFull enriches with row data). */
     onCellDblClick?: (item: Item, cell: GridlerCell) => void;
+    /** Called when a body row is clicked. */
+    onRowClick?: (row: number) => void;
+    /** Called when a body row receives a context-menu event. */
+    onRowContextMenu?: (row: number) => void;
     /** Called when Tab moves past the last column of the last row. */
     onRowAppended?: () => void;
     /** Called when Delete/Backspace is pressed with a selection. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warkypublic/svelix",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "Svelte 5 component library with Skeleton UI and Tailwind CSS",
   "license": "Apache-2.0",
   "exports": {