@almadar/ui 6.12.0 → 6.14.0

package/dist/runtime/index.d.cts

@@ -5,17 +5,18 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-D5lRu6p1.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-D5lRu6p1.cjs';
-import '../verificationRegistry-BLsjb1oU.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-BMz9xiBa.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-BMz9xiBa.cjs';
+import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
+import { b as UserData } from '../UserContext-D566nfWA.cjs';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-Czc2JAxo.cjs';
 export { p as profilerOnRender, u as usePerfBuffer } from '../perf-DaVdsbU0.cjs';
 import '../event-bus-types-Bl78kokd.cjs';
 import '../useUISlots-GNwGLlW2.cjs';
 import '@almadar/core/patterns';
-import '../paintDispatch-CK5uwYEq.cjs';
+import '../paintDispatch-Dh1pgljl.cjs';
 
 interface TraitStateMachineResult {
     /** Current state for each trait */
@@ -59,8 +60,6 @@ interface UseTraitStateMachineOptions {
     navigateBack?: () => void;
     /** Payload merged into the mount-time lifecycle INIT (route params from a parameterized page path). */
     initPayload?: EventPayload;
-    /** Notification function for notify effects */
-    notify?: (message: string, type?: 'success' | 'error' | 'warning' | 'info') => void;
     /**
      * Offline-preview persistence layer. When set, the client runtime merges
      * `@almadar/runtime` `createServerEffectHandlers` on top of the default
@@ -199,7 +198,6 @@ interface CreateClientEffectHandlersOptions {
     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
      * @entity.<field> value)` runs entirely in the browser for in-memory
@@ -278,6 +276,12 @@ interface OrbPreviewProps {
      * to walk DealCreate, NoteCompose, etc. on their owning pages.
      */
     initialPagePath?: string;
+    /**
+     * The signed-in viewer — forwarded to `OrbitalProvider`'s `UserProvider` so
+     * `@user.x` resolves in client-side guard and effect evaluation exactly as
+     * it does on the server. Omitted → anonymous.
+     */
+    user?: UserData | null;
     /**
      * Sandbox mode: the preview's event bus stays context-local and does NOT
      * register as the global bus. Set when embedded inside a host app (e.g. the
@@ -299,7 +303,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, user, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }
@@ -384,7 +388,7 @@ declare function BrowserPlayground({ schema, mode, initialPagePath, height, clas
 
 /** Verbs a host may deny. Never includes `emit` — the runtime's own emit
  *  handler drives the internal `listens` cascade and must never be replaced. */
-type PluginHostDenyVerb = 'persist' | 'call-service' | 'navigate' | 'notify';
+type PluginHostDenyVerb = 'persist' | 'call-service' | 'navigate';
 /** One bus-event → orbital-event wiring: `UI:<busEvent>` dispatches `trigger` at `orbital`/`trait`. */
 interface PluginHostInbound {
     busEvent: string;
@@ -407,7 +411,6 @@ interface OrbitalPluginHostProps {
     /** OPTIONAL policy: verbs listed here are denied with a logged warning, never a throw. Default: none denied. */
     deny?: PluginHostDenyVerb[];
     navigate?: (path: string) => void;
-    notify?: (message: string, type?: string) => void;
     onTransition?: (pluginId: string, orbital: string, trait: string, state: string) => void;
     children?: ReactNode;
 }
@@ -440,6 +443,6 @@ declare function useOrbitalPluginHost(): {
  * `children` passthrough — MUST be mounted inside `EventBusProvider` +
  * `UISlotProvider`.
  */
-declare function OrbitalPluginHost({ plugins, mode, transport, deny, navigate, notify, onTransition, children, }: OrbitalPluginHostProps): React__default.ReactElement;
+declare function OrbitalPluginHost({ plugins, mode, transport, deny, navigate, onTransition, children, }: OrbitalPluginHostProps): React__default.ReactElement;
 
 export { AccessTokenProvider, BrowserPlayground, type BrowserPlaygroundProps, type ClientEventBus, type CreateClientEffectHandlersOptions, OrbPreview, type OrbPreviewProps, OrbitalPluginHost, type OrbitalPluginHostProps, type PluginHostDenyVerb, type PluginHostInbound, type PluginHostPlugin, type ResolvedSchemaResult, ServerBridgeTransport, type SlotPatternEntry, type SlotSetter, type SlotSource, type TraitStateMachineResult, type UseTraitStateMachineOptions, clearSchemaCache, createClientEffectHandlers, useDeclaredCaptureTable, useOrbitalPluginHost, useResolvedSchema, useTraitStateMachine };

package/dist/runtime/index.d.ts

@@ -5,17 +5,18 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-D5lRu6p1.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-D5lRu6p1.js';
-import '../verificationRegistry-D8bHWD8Q.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-BMz9xiBa.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-BMz9xiBa.js';
+import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
+import { b as UserData } from '../UserContext-D566nfWA.js';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-Czc2JAxo.js';
 export { p as profilerOnRender, u as usePerfBuffer } from '../perf-DaVdsbU0.js';
 import '../event-bus-types-Bl78kokd.js';
 import '../useUISlots-GNwGLlW2.js';
 import '@almadar/core/patterns';
-import '../paintDispatch-CK5uwYEq.js';
+import '../paintDispatch-Dh1pgljl.js';
 
 interface TraitStateMachineResult {
     /** Current state for each trait */
@@ -59,8 +60,6 @@ interface UseTraitStateMachineOptions {
     navigateBack?: () => void;
     /** Payload merged into the mount-time lifecycle INIT (route params from a parameterized page path). */
     initPayload?: EventPayload;
-    /** Notification function for notify effects */
-    notify?: (message: string, type?: 'success' | 'error' | 'warning' | 'info') => void;
     /**
      * Offline-preview persistence layer. When set, the client runtime merges
      * `@almadar/runtime` `createServerEffectHandlers` on top of the default
@@ -199,7 +198,6 @@ interface CreateClientEffectHandlersOptions {
     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
      * @entity.<field> value)` runs entirely in the browser for in-memory
@@ -278,6 +276,12 @@ interface OrbPreviewProps {
      * to walk DealCreate, NoteCompose, etc. on their owning pages.
      */
     initialPagePath?: string;
+    /**
+     * The signed-in viewer — forwarded to `OrbitalProvider`'s `UserProvider` so
+     * `@user.x` resolves in client-side guard and effect evaluation exactly as
+     * it does on the server. Omitted → anonymous.
+     */
+    user?: UserData | null;
     /**
      * Sandbox mode: the preview's event bus stays context-local and does NOT
      * register as the global bus. Set when embedded inside a host app (e.g. the
@@ -299,7 +303,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, user, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }
@@ -384,7 +388,7 @@ declare function BrowserPlayground({ schema, mode, initialPagePath, height, clas
 
 /** Verbs a host may deny. Never includes `emit` — the runtime's own emit
  *  handler drives the internal `listens` cascade and must never be replaced. */
-type PluginHostDenyVerb = 'persist' | 'call-service' | 'navigate' | 'notify';
+type PluginHostDenyVerb = 'persist' | 'call-service' | 'navigate';
 /** One bus-event → orbital-event wiring: `UI:<busEvent>` dispatches `trigger` at `orbital`/`trait`. */
 interface PluginHostInbound {
     busEvent: string;
@@ -407,7 +411,6 @@ interface OrbitalPluginHostProps {
     /** OPTIONAL policy: verbs listed here are denied with a logged warning, never a throw. Default: none denied. */
     deny?: PluginHostDenyVerb[];
     navigate?: (path: string) => void;
-    notify?: (message: string, type?: string) => void;
     onTransition?: (pluginId: string, orbital: string, trait: string, state: string) => void;
     children?: ReactNode;
 }
@@ -440,6 +443,6 @@ declare function useOrbitalPluginHost(): {
  * `children` passthrough — MUST be mounted inside `EventBusProvider` +
  * `UISlotProvider`.
  */
-declare function OrbitalPluginHost({ plugins, mode, transport, deny, navigate, notify, onTransition, children, }: OrbitalPluginHostProps): React__default.ReactElement;
+declare function OrbitalPluginHost({ plugins, mode, transport, deny, navigate, onTransition, children, }: OrbitalPluginHostProps): React__default.ReactElement;
 
 export { AccessTokenProvider, BrowserPlayground, type BrowserPlaygroundProps, type ClientEventBus, type CreateClientEffectHandlersOptions, OrbPreview, type OrbPreviewProps, OrbitalPluginHost, type OrbitalPluginHostProps, type PluginHostDenyVerb, type PluginHostInbound, type PluginHostPlugin, type ResolvedSchemaResult, ServerBridgeTransport, type SlotPatternEntry, type SlotSetter, type SlotSource, type TraitStateMachineResult, type UseTraitStateMachineOptions, clearSchemaCache, createClientEffectHandlers, useDeclaredCaptureTable, useOrbitalPluginHost, useResolvedSchema, useTraitStateMachine };