@almadar/ui 5.127.0 → 5.128.0

package/dist/{UserContext-BKckAUv7.d.cts → UserContext-g_LcDiGN.d.cts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode, ReactElement } from 'react';
-import { ThemeRef, FieldValue } from '@almadar/core';
+import { ThemeRef, UserContext as UserContext$1, FieldValue } from '@almadar/core';
 
 /**
  * Unified ThemeContext - Single provider for theme and color mode
@@ -187,23 +187,11 @@ declare const useCurrentPagePath: () => string | undefined;
  */
 
 /**
- * User data for @user bindings.
- * Matches UserContext type from evaluator/context.ts
+ * User data for `@user` bindings — the canonical `UserContext` from
+ * `@almadar/core`, kept under this name for existing consumers. Declaring the
+ * shape locally let it drift from the type both execution paths resolve against.
  */
-interface UserData {
-    /** User's unique ID */
-    id: string;
-    /** User's email */
-    email?: string;
-    /** User's display name */
-    name?: string;
-    /** User's role (for RBAC) */
-    role?: string;
-    /** User's permissions */
-    permissions?: string[];
-    /** Additional custom profile fields */
-    [key: string]: FieldValue | undefined;
-}
+type UserData = UserContext$1;
 /**
  * User context value.
  */
@@ -223,10 +211,6 @@ interface UserContextValue {
     /** Get a user field by path (for @user.field bindings) */
     getUserField: (path: string) => FieldValue | undefined;
 }
-/**
- * Anonymous user for when no user is logged in.
- */
-declare const ANONYMOUS_USER: UserData;
 declare const UserContext: React__default.Context<UserContextValue | null>;
 interface UserProviderProps {
     /** User data (null if not logged in) */
@@ -275,4 +259,4 @@ declare function useHasPermission(permission: string): boolean;
  */
 declare function useUserForEvaluation(): UserData | undefined;
 
-export { ANONYMOUS_USER as A, BUILT_IN_THEMES as B, type ColorMode as C, type DesignTheme as D, OrbitalThemeProvider as O, type ResolvedMode as R, ThemeContext as T, type UIThemeDefinition as U, CurrentPagePathContext as a, CurrentPagePathProvider as b, type CurrentPagePathProviderProps as c, DesignThemeProvider as d, type OrbitalThemeProviderProps as e, ThemeProvider as f, type ThemeProviderProps as g, UserContext as h, type UserContextValue as i, type UserData as j, UserProvider as k, type UserProviderProps as l, useDesignTheme as m, useHasPermission as n, useHasRole as o, useTheme as p, useUser as q, useUserForEvaluation as r, useCurrentPagePath as u };
+export { BUILT_IN_THEMES as B, type ColorMode as C, type DesignTheme as D, OrbitalThemeProvider as O, type ResolvedMode as R, ThemeContext as T, type UIThemeDefinition as U, CurrentPagePathContext as a, CurrentPagePathProvider as b, type CurrentPagePathProviderProps as c, DesignThemeProvider as d, type OrbitalThemeProviderProps as e, ThemeProvider as f, type ThemeProviderProps as g, UserContext as h, type UserContextValue as i, type UserData as j, UserProvider as k, type UserProviderProps as l, useDesignTheme as m, useHasPermission as n, useHasRole as o, useTheme as p, useUser as q, useUserForEvaluation as r, useCurrentPagePath as u };

package/dist/{UserContext-BKckAUv7.d.ts → UserContext-g_LcDiGN.d.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode, ReactElement } from 'react';
-import { ThemeRef, FieldValue } from '@almadar/core';
+import { ThemeRef, UserContext as UserContext$1, FieldValue } from '@almadar/core';
 
 /**
  * Unified ThemeContext - Single provider for theme and color mode
@@ -187,23 +187,11 @@ declare const useCurrentPagePath: () => string | undefined;
  */
 
 /**
- * User data for @user bindings.
- * Matches UserContext type from evaluator/context.ts
+ * User data for `@user` bindings — the canonical `UserContext` from
+ * `@almadar/core`, kept under this name for existing consumers. Declaring the
+ * shape locally let it drift from the type both execution paths resolve against.
  */
-interface UserData {
-    /** User's unique ID */
-    id: string;
-    /** User's email */
-    email?: string;
-    /** User's display name */
-    name?: string;
-    /** User's role (for RBAC) */
-    role?: string;
-    /** User's permissions */
-    permissions?: string[];
-    /** Additional custom profile fields */
-    [key: string]: FieldValue | undefined;
-}
+type UserData = UserContext$1;
 /**
  * User context value.
  */
@@ -223,10 +211,6 @@ interface UserContextValue {
     /** Get a user field by path (for @user.field bindings) */
     getUserField: (path: string) => FieldValue | undefined;
 }
-/**
- * Anonymous user for when no user is logged in.
- */
-declare const ANONYMOUS_USER: UserData;
 declare const UserContext: React__default.Context<UserContextValue | null>;
 interface UserProviderProps {
     /** User data (null if not logged in) */
@@ -275,4 +259,4 @@ declare function useHasPermission(permission: string): boolean;
  */
 declare function useUserForEvaluation(): UserData | undefined;
 
-export { ANONYMOUS_USER as A, BUILT_IN_THEMES as B, type ColorMode as C, type DesignTheme as D, OrbitalThemeProvider as O, type ResolvedMode as R, ThemeContext as T, type UIThemeDefinition as U, CurrentPagePathContext as a, CurrentPagePathProvider as b, type CurrentPagePathProviderProps as c, DesignThemeProvider as d, type OrbitalThemeProviderProps as e, ThemeProvider as f, type ThemeProviderProps as g, UserContext as h, type UserContextValue as i, type UserData as j, UserProvider as k, type UserProviderProps as l, useDesignTheme as m, useHasPermission as n, useHasRole as o, useTheme as p, useUser as q, useUserForEvaluation as r, useCurrentPagePath as u };
+export { BUILT_IN_THEMES as B, type ColorMode as C, type DesignTheme as D, OrbitalThemeProvider as O, type ResolvedMode as R, ThemeContext as T, type UIThemeDefinition as U, CurrentPagePathContext as a, CurrentPagePathProvider as b, type CurrentPagePathProviderProps as c, DesignThemeProvider as d, type OrbitalThemeProviderProps as e, ThemeProvider as f, type ThemeProviderProps as g, UserContext as h, type UserContextValue as i, type UserData as j, UserProvider as k, type UserProviderProps as l, useDesignTheme as m, useHasPermission as n, useHasRole as o, useTheme as p, useUser as q, useUserForEvaluation as r, useCurrentPagePath as u };

package/dist/avl/index.cjs

@@ -24334,7 +24334,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxRuntime.jsxs(
                               Button,
                               {

package/dist/avl/index.js

@@ -24258,7 +24258,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxs(
                               Button,
                               {

package/dist/components/index.cjs

@@ -19648,7 +19648,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxRuntime.jsxs(exports.Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxRuntime.jsxs(exports.Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxRuntime.jsxs(
                               exports.Button,
                               {

package/dist/components/index.js

@@ -19573,7 +19573,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxs(
                               Button,
                               {

package/dist/context/index.d.cts

@@ -1,7 +1,7 @@
 export { U as UISlotContext, a as UISlotProvider, u as useSlotContent, b as useSlotHasContent, c as useUISlots } from '../UISlotContext-D8_SoDsD.cjs';
-export { A as ANONYMOUS_USER, B as BUILT_IN_THEMES, C as ColorMode, a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, D as DesignTheme, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, R as ResolvedMode, T as ThemeContext, f as ThemeProvider, g as ThemeProviderProps, U as UIThemeDefinition, h as UserContext, i as UserContextValue, j as UserData, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, p as useTheme, q as useUser, r as useUserForEvaluation } from '../UserContext-BKckAUv7.cjs';
+export { B as BUILT_IN_THEMES, C as ColorMode, a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, D as DesignTheme, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, R as ResolvedMode, T as ThemeContext, f as ThemeProvider, g as ThemeProviderProps, U as UIThemeDefinition, h as UserContext, i as UserContextValue, j as UserData, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, p as useTheme, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.cjs';
 import { ThemeRef, ThemeDefinition, ThemeTokens, ThemeVariant } from '@almadar/core';
-export { UISlot } from '@almadar/core';
+export { ANONYMOUS_USER, UISlot } from '@almadar/core';
 export { S as SlotAnimation, a as SlotChangeCallback, b as SlotContent, c as SlotRenderConfig, U as UISlotManager } from '../useUISlots-BesZYMks.cjs';
 import 'react';
 

package/dist/context/index.d.ts

@@ -1,7 +1,7 @@
 export { U as UISlotContext, a as UISlotProvider, u as useSlotContent, b as useSlotHasContent, c as useUISlots } from '../UISlotContext-C1FsU9GB.js';
-export { A as ANONYMOUS_USER, B as BUILT_IN_THEMES, C as ColorMode, a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, D as DesignTheme, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, R as ResolvedMode, T as ThemeContext, f as ThemeProvider, g as ThemeProviderProps, U as UIThemeDefinition, h as UserContext, i as UserContextValue, j as UserData, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, p as useTheme, q as useUser, r as useUserForEvaluation } from '../UserContext-BKckAUv7.js';
+export { B as BUILT_IN_THEMES, C as ColorMode, a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, D as DesignTheme, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, R as ResolvedMode, T as ThemeContext, f as ThemeProvider, g as ThemeProviderProps, U as UIThemeDefinition, h as UserContext, i as UserContextValue, j as UserData, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, p as useTheme, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.js';
 import { ThemeRef, ThemeDefinition, ThemeTokens, ThemeVariant } from '@almadar/core';
-export { UISlot } from '@almadar/core';
+export { ANONYMOUS_USER, UISlot } from '@almadar/core';
 export { S as SlotAnimation, a as SlotChangeCallback, b as SlotContent, c as SlotRenderConfig, U as UISlotManager } from '../useUISlots-BesZYMks.js';
 import 'react';
 

package/dist/providers/index.cjs

@@ -22068,7 +22068,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxRuntime.jsxs(
                               Button,
                               {
@@ -45154,6 +45154,96 @@ function VerificationProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
 }
 VerificationProvider.displayName = "VerificationProvider";
+var UserContext = React84.createContext(null);
+function UserProvider({
+  user = null,
+  children
+}) {
+  const hasRole = React84.useCallback(
+    (role) => {
+      if (!user) return role === "anonymous";
+      return user.role === role;
+    },
+    [user]
+  );
+  const hasPermission = React84.useCallback(
+    (permission) => {
+      if (!user) return false;
+      return user.permissions?.includes(permission) ?? false;
+    },
+    [user]
+  );
+  const hasAnyRole = React84.useCallback(
+    (roles) => {
+      if (!user) return roles.includes("anonymous");
+      return user.role ? roles.includes(user.role) : false;
+    },
+    [user]
+  );
+  const hasAllPermissions = React84.useCallback(
+    (permissions) => {
+      if (!user || !user.permissions) return false;
+      return permissions.every((p) => user.permissions?.includes(p));
+    },
+    [user]
+  );
+  const getUserField = React84.useCallback(
+    (path) => {
+      const viewer = user ?? core.ANONYMOUS_USER;
+      const [first, ...rest] = path.split(".");
+      if (!first) return void 0;
+      let value = viewer[first];
+      for (const segment of rest) {
+        if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date) {
+          return void 0;
+        }
+        value = value[segment];
+      }
+      return value;
+    },
+    [user]
+  );
+  const contextValue = React84.useMemo(
+    () => ({
+      user,
+      isLoggedIn: user !== null,
+      hasRole,
+      hasPermission,
+      hasAnyRole,
+      hasAllPermissions,
+      getUserField
+    }),
+    [user, hasRole, hasPermission, hasAnyRole, hasAllPermissions, getUserField]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(UserContext.Provider, { value: contextValue, children });
+}
+function useUser() {
+  const context = React84.useContext(UserContext);
+  if (!context) {
+    return {
+      user: null,
+      isLoggedIn: false,
+      hasRole: (role) => role === "anonymous",
+      hasPermission: () => false,
+      hasAnyRole: (roles) => roles.includes("anonymous"),
+      hasAllPermissions: () => false,
+      getUserField: () => void 0
+    };
+  }
+  return context;
+}
+function useHasRole(role) {
+  const { hasRole } = useUser();
+  return hasRole(role);
+}
+function useHasPermission(permission) {
+  const { hasPermission } = useUser();
+  return hasPermission(permission);
+}
+function useUserForEvaluation() {
+  const { user, isLoggedIn } = useUser();
+  return isLoggedIn && user ? user : void 0;
+}
 function OrbitalProvider({
   children,
   themes,
@@ -45165,13 +45255,14 @@ function OrbitalProvider({
   initialData,
   suspense = false,
   verification,
-  isolated = false
+  isolated = false,
+  user = null
 }) {
   const suspenseConfig = React84.useMemo(
     () => ({ enabled: suspense }),
     [suspense]
   );
-  const inner = /* @__PURE__ */ jsxRuntime.jsx(EventBusProvider, { debug: debug2, isolated, children: /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsxRuntime.jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsxRuntime.jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) });
+  const inner = /* @__PURE__ */ jsxRuntime.jsx(EventBusProvider, { debug: debug2, isolated, children: /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsxRuntime.jsx(UserProvider, { user, children: /* @__PURE__ */ jsxRuntime.jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsxRuntime.jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) }) });
   if (skipTheme) {
     return inner;
   }
@@ -45427,104 +45518,6 @@ var CurrentPagePathProvider = ({
 }) => /* @__PURE__ */ jsxRuntime.jsx(CurrentPagePathContext.Provider, { value, children });
 CurrentPagePathProvider.displayName = "CurrentPagePathProvider";
 var useCurrentPagePath2 = () => React84.useContext(CurrentPagePathContext);
-var ANONYMOUS_USER = {
-  id: "anonymous",
-  role: "anonymous",
-  permissions: []
-};
-var UserContext = React84.createContext(null);
-function UserProvider({
-  user = null,
-  children
-}) {
-  const hasRole = React84.useCallback(
-    (role) => {
-      if (!user) return role === "anonymous";
-      return user.role === role;
-    },
-    [user]
-  );
-  const hasPermission = React84.useCallback(
-    (permission) => {
-      if (!user) return false;
-      return user.permissions?.includes(permission) ?? false;
-    },
-    [user]
-  );
-  const hasAnyRole = React84.useCallback(
-    (roles) => {
-      if (!user) return roles.includes("anonymous");
-      return user.role ? roles.includes(user.role) : false;
-    },
-    [user]
-  );
-  const hasAllPermissions = React84.useCallback(
-    (permissions) => {
-      if (!user || !user.permissions) return false;
-      return permissions.every((p) => user.permissions?.includes(p));
-    },
-    [user]
-  );
-  const getUserField = React84.useCallback(
-    (path) => {
-      const userData = user ?? ANONYMOUS_USER;
-      const parts = path.split(".");
-      let value = userData;
-      for (const segment of parts) {
-        if (value === null || value === void 0) {
-          return void 0;
-        }
-        if (typeof value === "object") {
-          value = value[segment];
-        } else {
-          return void 0;
-        }
-      }
-      return value;
-    },
-    [user]
-  );
-  const contextValue = React84.useMemo(
-    () => ({
-      user,
-      isLoggedIn: user !== null,
-      hasRole,
-      hasPermission,
-      hasAnyRole,
-      hasAllPermissions,
-      getUserField
-    }),
-    [user, hasRole, hasPermission, hasAnyRole, hasAllPermissions, getUserField]
-  );
-  return /* @__PURE__ */ jsxRuntime.jsx(UserContext.Provider, { value: contextValue, children });
-}
-function useUser() {
-  const context = React84.useContext(UserContext);
-  if (!context) {
-    return {
-      user: null,
-      isLoggedIn: false,
-      hasRole: (role) => role === "anonymous",
-      hasPermission: () => false,
-      hasAnyRole: (roles) => roles.includes("anonymous"),
-      hasAllPermissions: () => false,
-      getUserField: () => void 0
-    };
-  }
-  return context;
-}
-function useHasRole(role) {
-  const { hasRole } = useUser();
-  return hasRole(role);
-}
-function useHasPermission(permission) {
-  const { hasPermission } = useUser();
-  return hasPermission(permission);
-}
-function useUserForEvaluation() {
-  const { user, isLoggedIn } = useUser();
-  return isLoggedIn && user ? user : void 0;
-}
 var EntitySchemaContext = React84.createContext(null);
 function EntitySchemaProvider({
   entities,
@@ -46248,7 +46241,10 @@ Object.defineProperty(exports, "useDesignTheme", {
   enumerable: true,
   get: function () { return context.useDesignTheme; }
 });
-exports.ANONYMOUS_USER = ANONYMOUS_USER;
+Object.defineProperty(exports, "ANONYMOUS_USER", {
+  enumerable: true,
+  get: function () { return core.ANONYMOUS_USER; }
+});
 exports.CurrentPagePathContext = CurrentPagePathContext;
 exports.CurrentPagePathProvider = CurrentPagePathProvider;
 exports.EntitySchemaProvider = EntitySchemaProvider;

package/dist/providers/index.d.cts

@@ -1,7 +1,8 @@
 import React__default, { ReactNode } from 'react';
 import { EntityRow, FieldValue } from '@almadar/core';
-import { U as UIThemeDefinition } from '../UserContext-BKckAUv7.cjs';
-export { A as ANONYMOUS_USER, a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, j as UserData, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-BKckAUv7.cjs';
+export { ANONYMOUS_USER } from '@almadar/core';
+import { U as UIThemeDefinition, j as UserData } from '../UserContext-g_LcDiGN.cjs';
+export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.cjs';
 export { E as EntitySchemaContextValue, a as EntitySchemaProvider, b as EntitySchemaProviderProps, S as SendEventResult, c as ServerBridgeContextValue, d as ServerBridgeProvider, e as ServerBridgeProviderProps, f as ServerBridgeTransport, g as ServerClientEffect, h as ServerResponseMeta, T as TraitContext, i as TraitContextValue, j as TraitInstance, k as TraitProvider, l as TraitProviderProps, u as useEntitySchema, m as useEntitySchemaOptional, n as useServerBridge, o as useTrait, p as useTraitContext } from '../TraitProvider-Ch79cUcb.cjs';
 import { U as UseOfflineExecutorResult, a as UseOfflineExecutorOptions } from '../offline-executor-Qz4b6GpF.cjs';
 export { N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, e as comparePathSpecificity, f as extractRouteParams, g as findPageByName, h as findPageByPath, i as getAllPages, j as getDefaultPage, m as matchPath, k as matchPathAmong, p as pathMatches, u as useActivePage, l as useInitPayload, n as useNavigateTo, o as useNavigation, q as useNavigationId, r as useNavigationState } from '../offline-executor-Qz4b6GpF.cjs';
@@ -145,6 +146,7 @@ declare function useSelectionOptional<T = EntityRow>(): SelectionContextType<T>
  * - ThemeProvider - Theme and color mode management
  * - EventBusProvider - Page-scoped event pub/sub
  * - SelectionProvider - Selected entity tracking
+ * - UserProvider - the viewer `@user.x` bindings resolve against
  *
  * Entity data flows through props (via enrichFromResponse in ServerBridge),
  * not through context. FetchedDataProvider has been removed.
@@ -188,6 +190,15 @@ interface OrbitalProviderProps {
      * preview's events don't clobber the host's global bus). Default false.
      */
     isolated?: boolean;
+    /**
+     * The signed-in viewer. Generated trait hooks read `@user.x` through
+     * `useUser()`, so without this every role gate takes its negative branch and
+     * every ownership-scoped list renders empty — silently, since `useUser()`
+     * falls back to anonymous rather than throwing
+     * (U-USERPROVIDER-MOUNTED-NOWHERE). Mounting the provider here means every
+     * host that already wraps its app in OrbitalProvider only has to pass the user.
+     */
+    user?: UserData | null;
 }
 /**
  * OrbitalProvider - Unified context provider for Orbital applications
@@ -236,7 +247,7 @@ interface OrbitalProviderProps {
  * }
  * ```
  */
-declare function OrbitalProvider({ children, themes, defaultTheme, defaultMode, targetRef, skipTheme, debug, initialData, suspense, verification, isolated, }: OrbitalProviderProps): React__default.ReactElement;
+declare function OrbitalProvider({ children, themes, defaultTheme, defaultMode, targetRef, skipTheme, debug, initialData, suspense, verification, isolated, user, }: OrbitalProviderProps): React__default.ReactElement;
 declare namespace OrbitalProvider {
     var displayName: string;
 }
@@ -454,4 +465,4 @@ declare function useOfflineMode(): OfflineModeContextValue;
  */
 declare function useOptionalOfflineMode(): OfflineModeContextValue | null;
 
-export { EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, VerificationProvider, type VerificationProviderProps, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };
+export { EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, UserData, VerificationProvider, type VerificationProviderProps, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };

package/dist/providers/index.d.ts

@@ -1,7 +1,8 @@
 import React__default, { ReactNode } from 'react';
 import { EntityRow, FieldValue } from '@almadar/core';
-import { U as UIThemeDefinition } from '../UserContext-BKckAUv7.js';
-export { A as ANONYMOUS_USER, a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, j as UserData, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-BKckAUv7.js';
+export { ANONYMOUS_USER } from '@almadar/core';
+import { U as UIThemeDefinition, j as UserData } from '../UserContext-g_LcDiGN.js';
+export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as CurrentPagePathProviderProps, d as DesignThemeProvider, O as OrbitalThemeProvider, e as OrbitalThemeProviderProps, h as UserContext, i as UserContextValue, k as UserProvider, l as UserProviderProps, u as useCurrentPagePath, m as useDesignTheme, n as useHasPermission, o as useHasRole, q as useUser, r as useUserForEvaluation } from '../UserContext-g_LcDiGN.js';
 export { E as EntitySchemaContextValue, a as EntitySchemaProvider, b as EntitySchemaProviderProps, S as SendEventResult, c as ServerBridgeContextValue, d as ServerBridgeProvider, e as ServerBridgeProviderProps, f as ServerBridgeTransport, g as ServerClientEffect, h as ServerResponseMeta, T as TraitContext, i as TraitContextValue, j as TraitInstance, k as TraitProvider, l as TraitProviderProps, u as useEntitySchema, m as useEntitySchemaOptional, n as useServerBridge, o as useTrait, p as useTraitContext } from '../TraitProvider-Ch79cUcb.js';
 import { U as UseOfflineExecutorResult, a as UseOfflineExecutorOptions } from '../offline-executor-Qz4b6GpF.js';
 export { N as NavigationContextValue, b as NavigationProvider, c as NavigationProviderProps, d as NavigationState, e as comparePathSpecificity, f as extractRouteParams, g as findPageByName, h as findPageByPath, i as getAllPages, j as getDefaultPage, m as matchPath, k as matchPathAmong, p as pathMatches, u as useActivePage, l as useInitPayload, n as useNavigateTo, o as useNavigation, q as useNavigationId, r as useNavigationState } from '../offline-executor-Qz4b6GpF.js';
@@ -145,6 +146,7 @@ declare function useSelectionOptional<T = EntityRow>(): SelectionContextType<T>
  * - ThemeProvider - Theme and color mode management
  * - EventBusProvider - Page-scoped event pub/sub
  * - SelectionProvider - Selected entity tracking
+ * - UserProvider - the viewer `@user.x` bindings resolve against
  *
  * Entity data flows through props (via enrichFromResponse in ServerBridge),
  * not through context. FetchedDataProvider has been removed.
@@ -188,6 +190,15 @@ interface OrbitalProviderProps {
      * preview's events don't clobber the host's global bus). Default false.
      */
     isolated?: boolean;
+    /**
+     * The signed-in viewer. Generated trait hooks read `@user.x` through
+     * `useUser()`, so without this every role gate takes its negative branch and
+     * every ownership-scoped list renders empty — silently, since `useUser()`
+     * falls back to anonymous rather than throwing
+     * (U-USERPROVIDER-MOUNTED-NOWHERE). Mounting the provider here means every
+     * host that already wraps its app in OrbitalProvider only has to pass the user.
+     */
+    user?: UserData | null;
 }
 /**
  * OrbitalProvider - Unified context provider for Orbital applications
@@ -236,7 +247,7 @@ interface OrbitalProviderProps {
  * }
  * ```
  */
-declare function OrbitalProvider({ children, themes, defaultTheme, defaultMode, targetRef, skipTheme, debug, initialData, suspense, verification, isolated, }: OrbitalProviderProps): React__default.ReactElement;
+declare function OrbitalProvider({ children, themes, defaultTheme, defaultMode, targetRef, skipTheme, debug, initialData, suspense, verification, isolated, user, }: OrbitalProviderProps): React__default.ReactElement;
 declare namespace OrbitalProvider {
     var displayName: string;
 }
@@ -454,4 +465,4 @@ declare function useOfflineMode(): OfflineModeContextValue;
  */
 declare function useOptionalOfflineMode(): OfflineModeContextValue | null;
 
-export { EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, VerificationProvider, type VerificationProviderProps, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };
+export { EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, UserData, VerificationProvider, type VerificationProviderProps, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };

package/dist/providers/index.js

@@ -68,7 +68,8 @@ import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
 import remarkMath from 'remark-math';
 import rehypeKatex from 'rehype-katex';
-import { isInlineTrait } from '@almadar/core';
+import { ANONYMOUS_USER, isInlineTrait } from '@almadar/core';
+export { ANONYMOUS_USER } from '@almadar/core';
 import { DndContext, pointerWithin, rectIntersection, closestCorners, useSensors, useSensor, PointerSensor, KeyboardSensor, useDroppable } from '@dnd-kit/core';
 import { useSortable, arrayMove, sortableKeyboardCoordinates, SortableContext, rectSortingStrategy, verticalListSortingStrategy } from '@dnd-kit/sortable';
 import { CSS } from '@dnd-kit/utilities';
@@ -21993,7 +21994,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxs(
                               Button,
                               {
@@ -45079,6 +45080,96 @@ function VerificationProvider({
   return /* @__PURE__ */ jsx(Fragment, { children });
 }
 VerificationProvider.displayName = "VerificationProvider";
+var UserContext = createContext(null);
+function UserProvider({
+  user = null,
+  children
+}) {
+  const hasRole = useCallback(
+    (role) => {
+      if (!user) return role === "anonymous";
+      return user.role === role;
+    },
+    [user]
+  );
+  const hasPermission = useCallback(
+    (permission) => {
+      if (!user) return false;
+      return user.permissions?.includes(permission) ?? false;
+    },
+    [user]
+  );
+  const hasAnyRole = useCallback(
+    (roles) => {
+      if (!user) return roles.includes("anonymous");
+      return user.role ? roles.includes(user.role) : false;
+    },
+    [user]
+  );
+  const hasAllPermissions = useCallback(
+    (permissions) => {
+      if (!user || !user.permissions) return false;
+      return permissions.every((p) => user.permissions?.includes(p));
+    },
+    [user]
+  );
+  const getUserField = useCallback(
+    (path) => {
+      const viewer = user ?? ANONYMOUS_USER;
+      const [first, ...rest] = path.split(".");
+      if (!first) return void 0;
+      let value = viewer[first];
+      for (const segment of rest) {
+        if (value === null || typeof value !== "object" || Array.isArray(value) || value instanceof Date) {
+          return void 0;
+        }
+        value = value[segment];
+      }
+      return value;
+    },
+    [user]
+  );
+  const contextValue = useMemo(
+    () => ({
+      user,
+      isLoggedIn: user !== null,
+      hasRole,
+      hasPermission,
+      hasAnyRole,
+      hasAllPermissions,
+      getUserField
+    }),
+    [user, hasRole, hasPermission, hasAnyRole, hasAllPermissions, getUserField]
+  );
+  return /* @__PURE__ */ jsx(UserContext.Provider, { value: contextValue, children });
+}
+function useUser() {
+  const context = useContext(UserContext);
+  if (!context) {
+    return {
+      user: null,
+      isLoggedIn: false,
+      hasRole: (role) => role === "anonymous",
+      hasPermission: () => false,
+      hasAnyRole: (roles) => roles.includes("anonymous"),
+      hasAllPermissions: () => false,
+      getUserField: () => void 0
+    };
+  }
+  return context;
+}
+function useHasRole(role) {
+  const { hasRole } = useUser();
+  return hasRole(role);
+}
+function useHasPermission(permission) {
+  const { hasPermission } = useUser();
+  return hasPermission(permission);
+}
+function useUserForEvaluation() {
+  const { user, isLoggedIn } = useUser();
+  return isLoggedIn && user ? user : void 0;
+}
 function OrbitalProvider({
   children,
   themes,
@@ -45090,13 +45181,14 @@ function OrbitalProvider({
   initialData,
   suspense = false,
   verification,
-  isolated = false
+  isolated = false,
+  user = null
 }) {
   const suspenseConfig = useMemo(
     () => ({ enabled: suspense }),
     [suspense]
   );
-  const inner = /* @__PURE__ */ jsx(EventBusProvider, { debug: debug2, isolated, children: /* @__PURE__ */ jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) });
+  const inner = /* @__PURE__ */ jsx(EventBusProvider, { debug: debug2, isolated, children: /* @__PURE__ */ jsx(VerificationProvider, { enabled: verification, children: /* @__PURE__ */ jsx(UserProvider, { user, children: /* @__PURE__ */ jsx(SelectionProvider, { debug: debug2, children: /* @__PURE__ */ jsx(SuspenseConfigProvider, { config: suspenseConfig, children }) }) }) }) });
   if (skipTheme) {
     return inner;
   }
@@ -45352,104 +45444,6 @@ var CurrentPagePathProvider = ({
 }) => /* @__PURE__ */ jsx(CurrentPagePathContext.Provider, { value, children });
 CurrentPagePathProvider.displayName = "CurrentPagePathProvider";
 var useCurrentPagePath2 = () => useContext(CurrentPagePathContext);
-var ANONYMOUS_USER = {
-  id: "anonymous",
-  role: "anonymous",
-  permissions: []
-};
-var UserContext = createContext(null);
-function UserProvider({
-  user = null,
-  children
-}) {
-  const hasRole = useCallback(
-    (role) => {
-      if (!user) return role === "anonymous";
-      return user.role === role;
-    },
-    [user]
-  );
-  const hasPermission = useCallback(
-    (permission) => {
-      if (!user) return false;
-      return user.permissions?.includes(permission) ?? false;
-    },
-    [user]
-  );
-  const hasAnyRole = useCallback(
-    (roles) => {
-      if (!user) return roles.includes("anonymous");
-      return user.role ? roles.includes(user.role) : false;
-    },
-    [user]
-  );
-  const hasAllPermissions = useCallback(
-    (permissions) => {
-      if (!user || !user.permissions) return false;
-      return permissions.every((p) => user.permissions?.includes(p));
-    },
-    [user]
-  );
-  const getUserField = useCallback(
-    (path) => {
-      const userData = user ?? ANONYMOUS_USER;
-      const parts = path.split(".");
-      let value = userData;
-      for (const segment of parts) {
-        if (value === null || value === void 0) {
-          return void 0;
-        }
-        if (typeof value === "object") {
-          value = value[segment];
-        } else {
-          return void 0;
-        }
-      }
-      return value;
-    },
-    [user]
-  );
-  const contextValue = useMemo(
-    () => ({
-      user,
-      isLoggedIn: user !== null,
-      hasRole,
-      hasPermission,
-      hasAnyRole,
-      hasAllPermissions,
-      getUserField
-    }),
-    [user, hasRole, hasPermission, hasAnyRole, hasAllPermissions, getUserField]
-  );
-  return /* @__PURE__ */ jsx(UserContext.Provider, { value: contextValue, children });
-}
-function useUser() {
-  const context = useContext(UserContext);
-  if (!context) {
-    return {
-      user: null,
-      isLoggedIn: false,
-      hasRole: (role) => role === "anonymous",
-      hasPermission: () => false,
-      hasAnyRole: (roles) => roles.includes("anonymous"),
-      hasAllPermissions: () => false,
-      getUserField: () => void 0
-    };
-  }
-  return context;
-}
-function useHasRole(role) {
-  const { hasRole } = useUser();
-  return hasRole(role);
-}
-function useHasPermission(permission) {
-  const { hasPermission } = useUser();
-  return hasPermission(permission);
-}
-function useUserForEvaluation() {
-  const { user, isLoggedIn } = useUser();
-  return isLoggedIn && user ? user : void 0;
-}
 var EntitySchemaContext = createContext(null);
 function EntitySchemaProvider({
   entities,
@@ -46165,4 +46159,4 @@ function GameAudioProvider2({
 }
 GameAudioProvider2.displayName = "GameAudioProvider";
 
-export { ANONYMOUS_USER, CurrentPagePathContext, CurrentPagePathProvider, EntitySchemaProvider, EventBusContext2 as EventBusContext, EventBusProvider, GameAudioContext2 as GameAudioContext, GameAudioProvider2 as GameAudioProvider, NavigationProvider2 as NavigationProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, TraitContext, TraitProvider, TraitScopeProvider3 as TraitScopeProvider, UserContext, UserProvider, VerificationProvider, comparePathSpecificity2 as comparePathSpecificity, extractRouteParams2 as extractRouteParams, findPageByName2 as findPageByName, findPageByPath2 as findPageByPath, getAllPages2 as getAllPages, getDefaultPage2 as getDefaultPage, matchPath2 as matchPath, matchPathAmong2 as matchPathAmong, pathMatches2 as pathMatches, useActivePage2 as useActivePage, useCurrentPagePath2 as useCurrentPagePath, useEntitySchema, useEntitySchemaOptional6 as useEntitySchemaOptional, useGameAudioContext2 as useGameAudioContext, useGameAudioContextOptional2 as useGameAudioContextOptional, useHasPermission, useHasRole, useInitPayload2 as useInitPayload, useNavigateTo2 as useNavigateTo, useNavigation2 as useNavigation, useNavigationId2 as useNavigationId, useNavigationState2 as useNavigationState, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useServerBridge, useTrait, useTraitContext, useTraitScope, useTraitScopeChain2 as useTraitScopeChain, useUser, useUserForEvaluation };
+export { CurrentPagePathContext, CurrentPagePathProvider, EntitySchemaProvider, EventBusContext2 as EventBusContext, EventBusProvider, GameAudioContext2 as GameAudioContext, GameAudioProvider2 as GameAudioProvider, NavigationProvider2 as NavigationProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, TraitContext, TraitProvider, TraitScopeProvider3 as TraitScopeProvider, UserContext, UserProvider, VerificationProvider, comparePathSpecificity2 as comparePathSpecificity, extractRouteParams2 as extractRouteParams, findPageByName2 as findPageByName, findPageByPath2 as findPageByPath, getAllPages2 as getAllPages, getDefaultPage2 as getDefaultPage, matchPath2 as matchPath, matchPathAmong2 as matchPathAmong, pathMatches2 as pathMatches, useActivePage2 as useActivePage, useCurrentPagePath2 as useCurrentPagePath, useEntitySchema, useEntitySchemaOptional6 as useEntitySchemaOptional, useGameAudioContext2 as useGameAudioContext, useGameAudioContextOptional2 as useGameAudioContextOptional, useHasPermission, useHasRole, useInitPayload2 as useInitPayload, useNavigateTo2 as useNavigateTo, useNavigation2 as useNavigation, useNavigationId2 as useNavigationId, useNavigationState2 as useNavigationState, useOfflineMode, useOptionalOfflineMode, useSelection, useSelectionOptional, useServerBridge, useTrait, useTraitContext, useTraitScope, useTraitScopeChain2 as useTraitScopeChain, useUser, useUserForEvaluation };

package/dist/runtime/index.cjs

@@ -21622,7 +21622,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxRuntime.jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxRuntime.jsxs(
                               Button,
                               {

package/dist/runtime/index.js

@@ -21548,7 +21548,7 @@ var init_DashboardLayout = __esm({
                               ]
                             }
                           ),
-                          user && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
+                          user?.name && /* @__PURE__ */ jsxs(Box, { className: "relative", children: [
                             /* @__PURE__ */ jsxs(
                               Button,
                               {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.127.0",
+  "version": "5.128.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -117,11 +117,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.35.0",
-    "@almadar/evaluator": "^2.36.0",
+    "@almadar/core": "^10.36.0",
+    "@almadar/evaluator": "^2.37.0",
     "@almadar/logger": "^1.10.0",
-    "@almadar/runtime": "^6.38.0",
-    "@almadar/std": "^16.145.0",
+    "@almadar/runtime": "^6.39.0",
+    "@almadar/std": "^16.146.0",
     "@almadar/syntax": "^1.12.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",