@almadar/ui 6.58.0 → 6.61.0

package/dist/providers/index.d.ts

@@ -1,5 +1,5 @@
 import React__default, { ReactNode } from 'react';
-import { EntityRow, SExpr, EventPayload, EffectTrace, SurfaceMode } from '@almadar/core';
+import { EntityRow, SExpr, EventPayload, EffectTrace, PageAccess, ViewerAuthority, SurfaceMode } from '@almadar/core';
 export { ANONYMOUS_USER, SurfaceMode, comparePathSpecificity, matchPath, matchPathAmong } from '@almadar/core';
 import { U as UIThemeDefinition } from '../ArbitraryClassCompiler-tChQ3nVq.js';
 export { A as ARBITRARY_CLASS_STYLE_ID, a as ArbitraryClassCompiler, b as ArbitraryClassCompilerProvider, c as ArbitraryClassCompilerProviderProps, d as CurrentPagePathContext, e as CurrentPagePathProvider, f as CurrentPagePathProviderProps, g as DesignThemeProvider, O as OrbitalThemeProvider, h as OrbitalThemeProviderProps, v as resetArbitraryClassStyles, u as useArbitraryClassStyles, n as useCurrentPagePath, o as useDesignTheme } from '../ArbitraryClassCompiler-tChQ3nVq.js';
@@ -10,11 +10,11 @@ export { N as NavPageDecl, a as NavStackApi, b as NavStackProvider, c as NavStac
 export { n as AwaitingSkeletonContext, A as AwaitingSkeletonSource, o as EntityBindingContext, E as EntityBindingSource, a as EntitySchemaContextValue, b as EntitySchemaProvider, c as EntitySchemaProviderProps, d as ServerBridgeContextValue, e as ServerBridgeProvider, p as ServerBridgeProviderProps, S as ServerBridgeTransport, T as TraitContext, f as TraitContextValue, g as TraitInstance, h as TraitProvider, i as TraitProviderProps, q as useAwaitingSkeleton, r as useEntityBindingSnapshot, u as useEntitySchema, j as useEntitySchemaOptional, k as useServerBridge, l as useTrait, m as useTraitContext } from '../AwaitingSkeletonContext-Bh399p1x.js';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-C0TWucBj.js';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, k as extractRouteParams, l as findPageByName, m as findPageByPath, n as getAllPages, o as getDefaultPage, p as pathMatches, u as useActivePage, q as useInitPayload, r as useNavigateTo, s as useNavigation, t as useNavigationId, v as useNavigationState } from '../offline-executor-C0TWucBj.js';
-import '../verificationRegistry-CK76GUfH.js';
-export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-kXbonWTv.js';
-export { A as Avl3DConfig, a as Avl3DContext, b as Avl3DModelOverrides, u as useAvl3DConfig, c as useAvl3DPalette } from '../avl-3d-context-BpBKZIbc.js';
+import '../verificationRegistry-B5aGl7WF.js';
+export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-Dv_L-PHt.js';
+export { A as Avl3DConfig, a as Avl3DContext, b as Avl3DModelOverrides, u as useAvl3DConfig, c as useAvl3DPalette } from '../avl-3d-context-Dxun3-ri.js';
 export { AccessTokenProvider } from '@almadar/runtime';
-import '../paintDispatch-BN8Vbzgs.js';
+import '../paintDispatch-Cp1_S93j.js';
 import 'lucide-react';
 import 'three';
 
@@ -509,6 +509,38 @@ declare function useOfflineMode(): OfflineModeContextValue;
  */
 declare function useOptionalOfflineMode(): OfflineModeContextValue | null;
 
+/**
+ * The page's declared `access`, enforced at the page boundary on both
+ * execution paths: an `access: authenticated` page's subtree (its whole trait
+ * circuit) mounts only once the host's auth provider has resolved an
+ * authenticated viewer, and is keyed by that viewer so a different user never
+ * inherits the previous user's circuit. Any other resolved authority sends the
+ * viewer to the app's declared `signIn` route. Public and undeclared pages pass
+ * straight through — no auth wait, no gate.
+ *
+ * @packageDocumentation
+ */
+
+interface PageAccessHostProps {
+    /** The page's declared `access:` modifier; absent = no gate. */
+    access?: PageAccess;
+    /** What the host's auth provider has resolved the viewer to be. */
+    authority: ViewerAuthority;
+    /** The admitted viewer's identity; a change remounts the page subtree. */
+    viewerId?: string;
+    /** The app's `signIn:` route. */
+    signIn?: string;
+    /** The concrete path being opened — handed to `onDenied` as the return path. */
+    path: string;
+    /** Navigate a non-admitted viewer to `signIn`, carrying `returnTo`. */
+    onDenied: (signIn: string, returnTo: string) => void;
+    children: React__default.ReactNode;
+}
+declare function PageAccessHost({ access, authority, viewerId, signIn, path, onDenied, children, }: PageAccessHostProps): React__default.ReactElement | null;
+declare namespace PageAccessHost {
+    var displayName: string;
+}
+
 /**
  * Content surfaces: the background box behind a content block (table,
  * calendar, list, chart …). Every block paints the theme-owned `.surface-content`
@@ -534,4 +566,4 @@ declare function useContentSurface(surface?: SurfaceMode): ContentSurface;
 /** True when an ancestor already painted a surface. */
 declare function useOnSurface(): boolean;
 
-export { type ContentSurface, EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, RenderSlotProvider, type RenderSlotProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, SurfaceBoundary, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, UserData, VerificationProvider, type VerificationProviderProps, mapServerEffectResults, useContentSurface, useOfflineMode, useOnSurface, useOptionalOfflineMode, useRenderSlot, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };
+export { type ContentSurface, EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, PageAccessHost, type PageAccessHostProps, RenderSlotProvider, type RenderSlotProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, SurfaceBoundary, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, UserData, VerificationProvider, type VerificationProviderProps, mapServerEffectResults, useContentSurface, useOfflineMode, useOnSurface, useOptionalOfflineMode, useRenderSlot, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };

package/dist/providers/index.js

@@ -1,26 +1,27 @@
-import { arbitraryClassesOf } from '../chunk-D2E44ODB.js';
-import { useGameAudio, SuspenseConfigProvider } from '../chunk-I2ZNE5TD.js';
-import { Box } from '../chunk-HA7CJWQX.js';
-import '../chunk-4ZGXIW3B.js';
-import '../chunk-I5QOYW2Z.js';
+import { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-ZR45FGW3.js';
+import { useGameAudio, arbitraryClassesOf, SuspenseConfigProvider } from '../chunk-6PV4LASE.js';
+import { Box } from '../chunk-MGN6B6OQ.js';
+import '../chunk-KZRAMPM6.js';
+import '../chunk-UTSDPJUP.js';
+import '../chunk-CB64IOYD.js';
 import '../chunk-XJTHMW4G.js';
 import { setGlobalEventBus, useEventBus } from '../chunk-CHNC4UYE.js';
-import '../chunk-KJGVLXEN.js';
-import { registerCheck, recordTransition, bindEventBus, bindTraitStateGetter } from '../chunk-Q47ZN2DW.js';
+import '../chunk-N4IJS5DD.js';
+import { registerCheck, recordTransition, bindEventBus, bindTraitStateGetter } from '../chunk-N23SVGTH.js';
 import { cn } from '../chunk-64WACXM7.js';
-import { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-V3FGTQUE.js';
-import '../chunk-723MJUU3.js';
-import '../chunk-LZRW6GXG.js';
+import '../chunk-6ZCU3BQN.js';
+import '../chunk-FYX64CDL.js';
+import '../chunk-L3MTZ3RH.js';
 import { useOfflineExecutor } from '../chunk-PQKU62LK.js';
 import '../chunk-PEST66PN.js';
 import '../chunk-QPXIAUJD.js';
-import React17, { createContext, useRef, useCallback, useMemo, useEffect, useState, useContext, useSyncExternalStore } from 'react';
+import React18, { createContext, useRef, useCallback, useMemo, useEffect, useState, useContext, useSyncExternalStore } from 'react';
 import { ThemeProvider, useThemeScope, useTheme, registryKeyTheme, themeHasMode, ThemeScopeContext } from '@almadar/ui/context';
 export { DesignThemeProvider, useDesignTheme } from '@almadar/ui/context';
 import { createLogger } from '@almadar/logger';
 import { jsx, Fragment } from 'react/jsx-runtime';
 import { useTranslate } from '@almadar/ui/hooks';
-import { ANONYMOUS_USER, isThemeRegistryKey, matchPath, matchPathAmong } from '@almadar/core';
+import { ANONYMOUS_USER, isThemeRegistryKey, matchPath, matchPathAmong, defaultPage } from '@almadar/core';
 export { ANONYMOUS_USER, comparePathSpecificity, matchPath, matchPathAmong } from '@almadar/core';
 import { createHttpTransport } from '@almadar/runtime';
 import { useLocation, useNavigate } from 'react-router-dom';
@@ -737,17 +738,7 @@ function findPageByName(schema, pageName) {
   return null;
 }
 function getDefaultPage(schema) {
-  if (!schema.orbitals) return null;
-  for (const orbital of schema.orbitals) {
-    if (!isInlineOrbital(orbital)) continue;
-    if (!orbital.pages) continue;
-    for (const pageRef of orbital.pages) {
-      if (isInlinePage(pageRef)) {
-        return { page: pageRef, orbitalName: orbital.name };
-      }
-    }
-  }
-  return null;
+  return defaultPage(schema);
 }
 function getAllPages(schema) {
   const pages = [];
@@ -782,9 +773,9 @@ function NavigationProvider({
       }
     }
     if (!page) {
-      const defaultPage = getDefaultPage(schema);
-      if (defaultPage) {
-        page = defaultPage.page;
+      const defaultPage2 = getDefaultPage(schema);
+      if (defaultPage2) {
+        page = defaultPage2.page;
         path = page.path || "/";
       }
     }
@@ -1158,6 +1149,25 @@ function GameAudioProvider({
   return /* @__PURE__ */ jsx(GameAudioContext.Provider, { value, children });
 }
 GameAudioProvider.displayName = "GameAudioProvider";
+function PageAccessHost({
+  access,
+  authority,
+  viewerId,
+  signIn,
+  path,
+  onDenied,
+  children
+}) {
+  const gated = access === "authenticated";
+  const denied = gated && authority !== "pending" && authority !== "authenticated";
+  useEffect(() => {
+    if (denied && signIn !== void 0) onDenied(signIn, path);
+  }, [denied, signIn, path, onDenied]);
+  if (!gated) return /* @__PURE__ */ jsx(Fragment, { children });
+  if (authority !== "authenticated") return null;
+  return /* @__PURE__ */ jsx(React18.Fragment, { children }, viewerId);
+}
+PageAccessHost.displayName = "PageAccessHost";
 function pageEntryLabel(page, navLabels) {
   return page.label ?? navLabels?.[page.path] ?? page.name;
 }
@@ -1450,12 +1460,12 @@ function useAvl3DConfig() {
 function useAvl3DPalette() {
   return useContext(Avl3DContext).palette;
 }
-var SurfaceContext = React17.createContext(false);
+var SurfaceContext = React18.createContext(false);
 function SurfaceBoundary({ children }) {
   return /* @__PURE__ */ jsx(SurfaceContext.Provider, { value: true, children });
 }
 function useContentSurface(surface = "auto") {
-  const onSurface = React17.useContext(SurfaceContext);
+  const onSurface = React18.useContext(SurfaceContext);
   const paints = surface === "auto" && !onSurface;
   return {
     className: paints ? "surface-content" : void 0,
@@ -1463,7 +1473,7 @@ function useContentSurface(surface = "auto") {
   };
 }
 function useOnSurface() {
-  return React17.useContext(SurfaceContext);
+  return React18.useContext(SurfaceContext);
 }
 
-export { ARBITRARY_CLASS_STYLE_ID, ArbitraryClassCompilerProvider, Avl3DContext, AwaitingSkeletonContext, CurrentPagePathContext, CurrentPagePathProvider, EntityBindingContext, EntitySchemaProvider, EventBusContext, EventBusProvider, GameAudioContext, GameAudioProvider, NavStackProvider, NavStackRouterBridge, NavigationProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, RenderSlotProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, SurfaceBoundary, TraitContext, TraitProvider, TraitScopeProvider, UserContext, UserProvider, VerificationProvider, extractRouteParams, findPageByName, findPageByPath, getAllPages, getDefaultPage, isInertNavStack, mapServerEffectResults, pathMatches, resetArbitraryClassStyles, useActivePage, useArbitraryClassStyles, useAvl3DConfig, useAvl3DPalette, useAwaitingSkeleton, useContentSurface, useCurrentPagePath, useEntityBindingSnapshot, useEntitySchema, useEntitySchemaOptional, useGameAudioContext, useGameAudioContextOptional, useHasPermission, useHasRole, useInitPayload, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOfflineMode, useOnSurface, useOptionalOfflineMode, useRenderSlot, useSelection, useSelectionOptional, useServerBridge, useTrait, useTraitContext, useTraitScope, useTraitScopeChain, useUser, useUserForEvaluation };
+export { ARBITRARY_CLASS_STYLE_ID, ArbitraryClassCompilerProvider, Avl3DContext, AwaitingSkeletonContext, CurrentPagePathContext, CurrentPagePathProvider, EntityBindingContext, EntitySchemaProvider, EventBusContext, EventBusProvider, GameAudioContext, GameAudioProvider, NavStackProvider, NavStackRouterBridge, NavigationProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, PageAccessHost, RenderSlotProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, SurfaceBoundary, TraitContext, TraitProvider, TraitScopeProvider, UserContext, UserProvider, VerificationProvider, extractRouteParams, findPageByName, findPageByPath, getAllPages, getDefaultPage, isInertNavStack, mapServerEffectResults, pathMatches, resetArbitraryClassStyles, useActivePage, useArbitraryClassStyles, useAvl3DConfig, useAvl3DPalette, useAwaitingSkeleton, useContentSurface, useCurrentPagePath, useEntityBindingSnapshot, useEntitySchema, useEntitySchemaOptional, useGameAudioContext, useGameAudioContextOptional, useHasPermission, useHasRole, useInitPayload, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOfflineMode, useOnSurface, useOptionalOfflineMode, useRenderSlot, useSelection, useSelectionOptional, useServerBridge, useTrait, useTraitContext, useTraitScope, useTraitScopeChain, useUser, useUserForEvaluation };