@almadar/ui 5.152.0 → 5.154.0

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
 import '../useEventBus-Ckr4wqW3.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport } from '../EntityBindingContext-CD9ZoXb4.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CD9ZoXb4.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport } from '../EntityBindingContext-BfZGeDfX.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-BfZGeDfX.cjs';
 import { PerfEntry } from '@almadar/runtime/ui';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ProfilerOnRenderCallback } from 'react';
@@ -40,8 +40,11 @@ interface UseTraitStateMachineOptions {
      * the consumer.
      */
     onEventProcessed?: (eventKey: string, payload?: EventPayload, dispatchedOrbitals?: Set<string>) => void | Promise<void>;
-    /** Router navigate function for navigate effects */
-    navigate?: (path: string, params?: Record<string, string>) => void;
+    /** Router navigate function for navigate effects. `crumb` labels the
+     * target page's navigation-stack entry (from the effect's options). */
+    navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;
+    /** Pop the orbital-scoped navigation stack (navigate-back effect). */
+    navigateBack?: () => void;
     /** Payload merged into the mount-time lifecycle INIT (route params from a parameterized page path). */
     initPayload?: EventPayload;
     /** Notification function for notify effects */
@@ -170,7 +173,11 @@ interface SlotSetter {
 interface CreateClientEffectHandlersOptions {
     eventBus: ClientEventBus;
     slotSetter: SlotSetter;
-    navigate?: (path: string, params?: Record<string, string>) => void;
+    /** Navigate handler. `crumb` labels the target page's navigation-stack
+     * entry (from the navigate effect's `{ crumb: … }` options). */
+    navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;
+    /** Pop the orbital-scoped navigation stack (navigate-back effect). */
+    navigateBack?: () => void;
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
     /**
      * Live client-entity write target for `[runtime]` entities. `(set

package/dist/runtime/index.d.ts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
 import '../useEventBus-CQWyAWpK.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport } from '../EntityBindingContext-CD9ZoXb4.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CD9ZoXb4.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport } from '../EntityBindingContext-BfZGeDfX.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-BfZGeDfX.js';
 import { PerfEntry } from '@almadar/runtime/ui';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ProfilerOnRenderCallback } from 'react';
@@ -40,8 +40,11 @@ interface UseTraitStateMachineOptions {
      * the consumer.
      */
     onEventProcessed?: (eventKey: string, payload?: EventPayload, dispatchedOrbitals?: Set<string>) => void | Promise<void>;
-    /** Router navigate function for navigate effects */
-    navigate?: (path: string, params?: Record<string, string>) => void;
+    /** Router navigate function for navigate effects. `crumb` labels the
+     * target page's navigation-stack entry (from the effect's options). */
+    navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;
+    /** Pop the orbital-scoped navigation stack (navigate-back effect). */
+    navigateBack?: () => void;
     /** Payload merged into the mount-time lifecycle INIT (route params from a parameterized page path). */
     initPayload?: EventPayload;
     /** Notification function for notify effects */
@@ -170,7 +173,11 @@ interface SlotSetter {
 interface CreateClientEffectHandlersOptions {
     eventBus: ClientEventBus;
     slotSetter: SlotSetter;
-    navigate?: (path: string, params?: Record<string, string>) => void;
+    /** Navigate handler. `crumb` labels the target page's navigation-stack
+     * entry (from the navigate effect's `{ crumb: … }` options). */
+    navigate?: (path: string, params?: Record<string, string>, crumb?: string) => void;
+    /** Pop the orbital-scoped navigation stack (navigate-back effect). */
+    navigateBack?: () => void;
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
     /**
      * Live client-entity write target for `[runtime]` entities. `(set