@almadar/ui 6.51.2 → 6.53.0

package/dist/providers/index.d.ts

@@ -1,20 +1,20 @@
 import React__default, { ReactNode } from 'react';
-import { EntityRow, SExpr, EventPayload, EffectTrace } from '@almadar/core';
-export { ANONYMOUS_USER, comparePathSpecificity, matchPath, matchPathAmong } from '@almadar/core';
+import { EntityRow, SExpr, EventPayload, EffectTrace, SurfaceMode } from '@almadar/core';
+export { ANONYMOUS_USER, SurfaceMode, comparePathSpecificity, matchPath, matchPathAmong } from '@almadar/core';
 import { U as UIThemeDefinition } from '../ArbitraryClassCompiler-DvzdeHxc.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, r as resetArbitraryClassStyles, u as useArbitraryClassStyles, m as useCurrentPagePath, n as useDesignTheme } from '../ArbitraryClassCompiler-DvzdeHxc.js';
 import { b as UserData } from '../UserContext-D566nfWA.js';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.js';
-import { E as EventBusContextType } from '../NavStackContext-B-XLULCO.js';
-export { N as NavPageDecl, a as NavStackApi, b as NavStackProvider, c as NavStackProviderProps, d as NavStackRouterBridge, e as NavStackRouterBridgeProps, i as isInertNavStack, u as useNavStack } from '../NavStackContext-B-XLULCO.js';
-export { n as EntityBindingContext, E as EntityBindingSource, a as EntitySchemaContextValue, b as EntitySchemaProvider, c as EntitySchemaProviderProps, d as ServerBridgeContextValue, e as ServerBridgeProvider, o as ServerBridgeProviderProps, S as ServerBridgeTransport, T as TraitContext, f as TraitContextValue, g as TraitInstance, h as TraitProvider, i as TraitProviderProps, p as useEntityBindingSnapshot, u as useEntitySchema, j as useEntitySchemaOptional, k as useServerBridge, l as useTrait, m as useTraitContext } from '../EntityBindingContext-BbxrwSb9.js';
+import { E as EventBusContextType } from '../NavStackContext-04NLdXsY.js';
+export { N as NavPageDecl, a as NavStackApi, b as NavStackProvider, c as NavStackProviderProps, d as NavStackRouterBridge, e as NavStackRouterBridgeProps, i as isInertNavStack, u as useNavStack } from '../NavStackContext-04NLdXsY.js';
+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-DBHfOR9y.js';
-export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-BgWLggIy.js';
+import '../verificationRegistry-CD7Xb40L.js';
+export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-DyBvYP2c.js';
 export { A as Avl3DConfig, a as Avl3DContext, b as Avl3DModelOverrides, u as useAvl3DConfig, c as useAvl3DPalette } from '../avl-3d-context-MAt_NuU9.js';
 export { AccessTokenProvider } from '@almadar/runtime';
-import '../paintDispatch-CMgOyVjS.js';
+import '../paintDispatch-_6EhJCiL.js';
 import 'lucide-react';
 import 'three';
 
@@ -509,4 +509,29 @@ declare function useOfflineMode(): OfflineModeContextValue;
  */
 declare function useOptionalOfflineMode(): OfflineModeContextValue | null;
 
-export { EventBusContext, EventBusProvider, type OfflineModeContextValue, OfflineModeProvider, type OfflineModeProviderProps, OrbitalProvider, type OrbitalProviderProps, RenderSlotProvider, type RenderSlotProviderProps, SelectionContext, type SelectionContextType, SelectionProvider, type TraitScope, TraitScopeProvider, type TraitScopeProviderProps, UIThemeDefinition, UserData, VerificationProvider, type VerificationProviderProps, mapServerEffectResults, useOfflineMode, useOptionalOfflineMode, useRenderSlot, useSelection, useSelectionOptional, useTraitScope, useTraitScopeChain };
+/**
+ * Content surfaces: the background box behind a content block (table,
+ * calendar, list, chart …). Every block paints the theme-owned `.surface-content`
+ * by default, so a patterned page never shows through one block and not the
+ * next; the THEME decides what that surface looks like via `--surface-content-*`.
+ *
+ * Anything that already is a surface (a Card, a dialog, a panel, or a block that
+ * painted one) marks its subtree, and a block inside that subtree stays flat —
+ * declared ancestry, so a surface never nests inside another.
+ */
+
+/** Marks its subtree as already sitting on a surface. */
+declare function SurfaceBoundary({ children }: {
+    children?: React__default.ReactNode;
+}): React__default.ReactElement;
+interface ContentSurface {
+    /** `surface-content` when this block paints the surface, otherwise undefined. */
+    className: string | undefined;
+    /** Wraps the block's content so nested blocks know they already sit on a surface. */
+    provide: (node: React__default.ReactNode) => React__default.ReactElement;
+}
+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 };

package/dist/providers/index.js

@@ -1,20 +1,20 @@
 import { arbitraryClassesOf } from '../chunk-ERXIHZW3.js';
-import { useGameAudio, SuspenseConfigProvider } from '../chunk-GIPZSCND.js';
-import { Box } from '../chunk-BUEIZY54.js';
-import '../chunk-MWPX2O4M.js';
-import '../chunk-NTO555KF.js';
+import { useGameAudio, SuspenseConfigProvider } from '../chunk-3EF5SDIJ.js';
+import { Box } from '../chunk-7LM6I3NA.js';
+import '../chunk-GMDMOYXD.js';
+import '../chunk-JRW33U35.js';
 import '../chunk-XJTHMW4G.js';
 import { setGlobalEventBus, useEventBus } from '../chunk-6EV3OEBQ.js';
-import { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-FGHRVJCI.js';
-import '../chunk-OLZ3EEML.js';
+import '../chunk-KQXXO42S.js';
 import { registerCheck, recordTransition, bindEventBus, bindTraitStateGetter } from '../chunk-O7OLVVBR.js';
-import '../chunk-HQDKHLFG.js';
-import '../chunk-GHXWGQTX.js';
-import '../chunk-L55SAFKL.js';
+import '../chunk-64WACXM7.js';
+import { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-6O37FCX4.js';
+import '../chunk-4OZDHCZV.js';
+import '../chunk-UGHAADU5.js';
 import { useOfflineExecutor } from '../chunk-PQKU62LK.js';
-import '../chunk-YHY5K2Y7.js';
+import '../chunk-PEST66PN.js';
 import '../chunk-QPXIAUJD.js';
-import { createContext, useRef, useCallback, useMemo, useEffect, useState, useContext, useSyncExternalStore } from 'react';
+import React17, { createContext, useRef, useCallback, useMemo, useEffect, useState, useContext, useSyncExternalStore } from 'react';
 import { ThemeProvider, useThemeScope, useTheme, ThemeScopeContext } from '@almadar/ui/context';
 export { DesignThemeProvider, useDesignTheme } from '@almadar/ui/context';
 import { createLogger } from '@almadar/logger';
@@ -1062,6 +1062,15 @@ function useEntityBindingSnapshot(traitName) {
     state: source !== null && traitName !== void 0 ? source.getState(traitName) : ""
   };
 }
+var AwaitingSkeletonContext = createContext(null);
+var NOOP_SUBSCRIBE2 = () => () => void 0;
+var ZERO = () => 0;
+function useAwaitingSkeleton(target) {
+  const source = useContext(AwaitingSkeletonContext);
+  useSyncExternalStore(source?.subscribe ?? NOOP_SUBSCRIBE2, source?.getVersion ?? ZERO, ZERO);
+  if (source === null) return void 0;
+  return "slot" in target ? source.forSlot(target.slot) : source.forTrait(target.trait);
+}
 var OfflineModeContext = createContext(null);
 function OfflineModeProvider({
   children,
@@ -1146,8 +1155,32 @@ function GameAudioProvider({
   return /* @__PURE__ */ jsx(GameAudioContext.Provider, { value, children });
 }
 GameAudioProvider.displayName = "GameAudioProvider";
-function pageEntryLabel(page) {
-  return page.label ?? page.name;
+function pageEntryLabel(page, navLabels) {
+  return page.label ?? navLabels?.[page.path] ?? page.name;
+}
+function navLabelsFromItems(pages, items) {
+  const labels = {};
+  const visit = (list) => {
+    for (const item of list) {
+      const page = matchNavPage(pages, item.href);
+      if (page && item.label) labels[page.path] = item.label;
+      if (item.children) visit(item.children);
+    }
+  };
+  visit(items);
+  return labels;
+}
+function resolveEntryLabels(entries, pages, navLabels) {
+  let changed = false;
+  const resolved = entries.map((entry) => {
+    const page = matchNavPage(pages, entry.href);
+    if (!page || entry.label !== pageEntryLabel(page)) return entry;
+    const label = pageEntryLabel(page, navLabels);
+    if (label === entry.label) return entry;
+    changed = true;
+    return { ...entry, label };
+  });
+  return changed ? resolved : entries;
 }
 function normalizePath(p) {
   let normalized = p.trim();
@@ -1220,7 +1253,8 @@ var INERT_API = {
   beginNavigate: () => void 0,
   back: () => void 0,
   goTo: () => void 0,
-  setCurrentLabel: () => void 0
+  setCurrentLabel: () => void 0,
+  registerNavItems: () => void 0
 };
 var NavStackContext = createContext(INERT_API);
 function isInertNavStack(api) {
@@ -1250,6 +1284,14 @@ function persistStored(storageKey, state) {
   } catch {
   }
 }
+function sameNavItems(a, b) {
+  if (a === b) return true;
+  if (a.length !== b.length) return false;
+  return a.every((item, i) => {
+    const other = b[i];
+    return item.href === other.href && item.label === other.label && sameNavItems(item.children ?? [], other.children ?? []);
+  });
+}
 var NavStackProvider = ({
   pages,
   currentPath,
@@ -1258,6 +1300,7 @@ var NavStackProvider = ({
   children
 }) => {
   const [state, setState] = useState(() => loadStored(storageKey));
+  const [navItems, setNavItems] = useState([]);
   const pendingCrumbRef = useRef(null);
   const stateRef = useRef(state);
   stateRef.current = state;
@@ -1293,9 +1336,13 @@ var NavStackProvider = ({
     },
     [pages, currentPath, storageKey]
   );
+  const registerNavItems = useCallback((items) => {
+    setNavItems((prev) => sameNavItems(prev, items) ? prev : items);
+  }, []);
+  const navLabels = useMemo(() => navLabelsFromItems(pages, navItems), [pages, navItems]);
   const entries = useMemo(
-    () => entriesFor(state, pages, currentPath),
-    [state, pages, currentPath]
+    () => resolveEntryLabels(entriesFor(state, pages, currentPath), pages, navLabels),
+    [state, pages, currentPath, navLabels]
   );
   const api = useMemo(
     () => ({
@@ -1304,9 +1351,10 @@ var NavStackProvider = ({
       beginNavigate,
       back,
       goTo,
-      setCurrentLabel
+      setCurrentLabel,
+      registerNavItems
     }),
-    [entries, state, pages, currentPath, beginNavigate, back, goTo, setCurrentLabel]
+    [entries, state, pages, currentPath, beginNavigate, back, goTo, setCurrentLabel, registerNavItems]
   );
   return /* @__PURE__ */ jsx(NavStackContext.Provider, { value: api, children });
 };
@@ -1391,5 +1439,20 @@ function useAvl3DConfig() {
 function useAvl3DPalette() {
   return useContext(Avl3DContext).palette;
 }
+var SurfaceContext = React17.createContext(false);
+function SurfaceBoundary({ children }) {
+  return /* @__PURE__ */ jsx(SurfaceContext.Provider, { value: true, children });
+}
+function useContentSurface(surface = "auto") {
+  const onSurface = React17.useContext(SurfaceContext);
+  const paints = surface === "auto" && !onSurface;
+  return {
+    className: paints ? "surface-content" : void 0,
+    provide: (node) => paints ? /* @__PURE__ */ jsx(SurfaceBoundary, { children: node }) : /* @__PURE__ */ jsx(Fragment, { children: node })
+  };
+}
+function useOnSurface() {
+  return React17.useContext(SurfaceContext);
+}
 
-export { ARBITRARY_CLASS_STYLE_ID, ArbitraryClassCompilerProvider, Avl3DContext, CurrentPagePathContext, CurrentPagePathProvider, EntityBindingContext, EntitySchemaProvider, EventBusContext, EventBusProvider, GameAudioContext, GameAudioProvider, NavStackProvider, NavStackRouterBridge, NavigationProvider, OfflineModeProvider, OrbitalProvider, OrbitalThemeProvider, RenderSlotProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, TraitContext, TraitProvider, TraitScopeProvider, UserContext, UserProvider, VerificationProvider, extractRouteParams, findPageByName, findPageByPath, getAllPages, getDefaultPage, isInertNavStack, mapServerEffectResults, pathMatches, resetArbitraryClassStyles, useActivePage, useArbitraryClassStyles, useAvl3DConfig, useAvl3DPalette, useCurrentPagePath, useEntityBindingSnapshot, useEntitySchema, useEntitySchemaOptional, useGameAudioContext, useGameAudioContextOptional, useHasPermission, useHasRole, useInitPayload, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOfflineMode, 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, 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 };

package/dist/renderer/index.cjs

@@ -343,6 +343,12 @@ var SLOT_DEFINITIONS = {
     name: "sidebar",
     type: "inline"
   },
+  dock: {
+    name: "dock",
+    type: "portal",
+    portalTarget: "body",
+    zIndex: 850
+  },
   // -------------------------------------------------------------------------
   // Portal Slots - Render to document.body via React Portal
   // -------------------------------------------------------------------------

package/dist/renderer/index.d.ts

@@ -302,7 +302,7 @@ declare function hasEntities(entityName: string, context: DataContext): boolean;
  * Inline slots render within the component hierarchy.
  * Portal slots render to document.body, breaking out of overflow containers.
  */
-declare const SLOT_DEFINITIONS: Partial<Record<UISlot, SlotDefinition>> & Record<'main' | 'sidebar' | 'modal' | 'drawer' | 'overlay' | 'center' | 'toast' | 'hud-top' | 'hud-bottom' | 'floating', SlotDefinition>;
+declare const SLOT_DEFINITIONS: Partial<Record<UISlot, SlotDefinition>> & Record<'main' | 'sidebar' | 'dock' | 'modal' | 'drawer' | 'overlay' | 'center' | 'toast' | 'hud-top' | 'hud-bottom' | 'floating', SlotDefinition>;
 /**
  * Get the slot definition for a slot name.
  */

package/dist/renderer/index.js

@@ -1,3 +1,3 @@
 export { ClientEffectConfigContext, ClientEffectConfigProvider, NavigationProvider, OfflineExecutor, comparePathSpecificity, createOfflineExecutor, executeClientEffects, extractRouteParams, findPageByName, findPageByPath, getAllPages, getDefaultPage, getKnownPatterns, getPatternDefinition, getPatternMapping, getPatternsByCategory, getRenderUIEffects, hasEntities, initializePatternResolver, initializePatterns, isKnownPattern, matchPath, matchPathAmong, parseClientEffect, parseClientEffects, pathMatches, resolveEntityById, resolveEntityData, resolveEntityDataWithQuery, resolvePattern, setComponentMapping, setPatternRegistry, useActivePage, useClientEffectConfig, useClientEffectConfigOptional, useClientEffects, useInitPayload, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOfflineExecutor } from '../chunk-PQKU62LK.js';
-export { ALL_SLOTS, SLOT_DEFINITIONS, getInlineSlots, getSlotDefinition, isPortalSlot } from '../chunk-YHY5K2Y7.js';
+export { ALL_SLOTS, SLOT_DEFINITIONS, getInlineSlots, getSlotDefinition, isPortalSlot } from '../chunk-PEST66PN.js';
 import '../chunk-QPXIAUJD.js';