@almadar/ui 6.9.0 → 6.11.0

package/dist/runtime/index.d.cts

@@ -1,12 +1,13 @@
 import * as _almadar_core from '@almadar/core';
-import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, FieldValue, EventSource, SExpr, BusEventSource, EntityRow, EntityData } from '@almadar/core';
+import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, ResolvedPatternProps, EventSource, SExpr, BusEventSource, EntityRow, EntityData } from '@almadar/core';
 export { ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
 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 } from '../EntityBindingContext-Bn3ePJQC.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-Bn3ePJQC.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';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-Czc2JAxo.cjs';
@@ -14,6 +15,7 @@ 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';
 
 interface TraitStateMachineResult {
     /** Current state for each trait */
@@ -95,6 +97,15 @@ interface UseTraitStateMachineOptions {
      * compiled-path codegen semantics.
      */
     embeddedTraits?: ReadonlySet<string>;
+    /**
+     * Referrer trait name → the DIRECT children (via `@trait.X`) that need
+     * their lifecycle transition re-run under the referrer's payload
+     * whenever the referrer's own transition fires — built by the caller
+     * via `@almadar/core`'s `collectCallsiteCaptureChildren` (merged across
+     * every orbital in the resolved schema, the same flattening
+     * `orbitalsByTrait` uses). See `reRenderCallsiteCaptureChildren`.
+     */
+    callsiteCaptureChildrenByTrait?: ReadonlyMap<string, ReadonlySet<string>>;
 }
 declare function useTraitStateMachine(traitBindings: ResolvedTraitBinding[], uiSlots: ReturnType<typeof useUISlots>, options?: UseTraitStateMachineOptions): TraitStateMachineResult;
 
@@ -149,7 +160,7 @@ declare function clearSchemaCache(): void;
  */
 interface SlotPatternEntry {
     pattern: PatternConfig;
-    props: Record<string, FieldValue | undefined>;
+    props: ResolvedPatternProps;
 }
 /**
  * The originating trait + state for a slot write. Embedded in the
@@ -177,7 +188,7 @@ interface ClientEventBus {
     emit: (type: string, payload?: EventPayload, source?: BusEventSource) => void;
 }
 interface SlotSetter {
-    addPattern: (slot: string, pattern: PatternConfig | null, props?: Record<string, FieldValue | undefined>) => void;
+    addPattern: (slot: string, pattern: PatternConfig | null, props?: ResolvedPatternProps) => void;
     clearSlot: (slot: string) => void;
 }
 interface CreateClientEffectHandlersOptions {
@@ -200,6 +211,17 @@ interface CreateClientEffectHandlersOptions {
      * and ticks — no guard-vs-render split.
      */
     liveEntity?: EntityRow;
+    /**
+     * Bridge mode — no local persistence adapter is wired, so the SERVER
+     * executes every persist and returns its outcome. Sets
+     * `EffectHandlers.persistDelegated` so the executor skips the placeholder
+     * `persist` below instead of reading its `undefined` as a denial
+     * (an error in every browser console + a client-side `failure` emit
+     * while the server had succeeded). The hook decides this from whether a
+     * `persistence` adapter was supplied — `liveEntity` says nothing about
+     * it (the hook always binds one for `(set @entity.X)`).
+     */
+    persistDelegated?: boolean;
     /**
      * Optional consumer-supplied call-service handler. When set, it runs
      * instead of the default mock fallback — use to wire the playground
@@ -246,6 +268,8 @@ interface OrbPreviewProps {
      * `OrbitalServerRuntime.processOrbitalEvent` directly without HTTP.
      */
     transport?: ServerBridgeTransport;
+    /** Bearer token for `serverUrl` requests (see `ServerBridgeProviderProps.getAccessToken`). */
+    getAccessToken?: AccessTokenProvider;
     /**
      * Initial page path to render (e.g. `/deals`). Resolves against the
      * schema's `pages[]` to seed `currentPage` so the right orbital's traits
@@ -275,7 +299,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, initialPagePath, isolated, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }
@@ -418,4 +442,4 @@ declare function useOrbitalPluginHost(): {
  */
 declare function OrbitalPluginHost({ plugins, mode, transport, deny, navigate, notify, onTransition, children, }: OrbitalPluginHostProps): React__default.ReactElement;
 
-export { 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 };
+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

@@ -1,12 +1,13 @@
 import * as _almadar_core from '@almadar/core';
-import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, FieldValue, EventSource, SExpr, BusEventSource, EntityRow, EntityData } from '@almadar/core';
+import { EventPayload, ServiceParams, ResolvedTraitBinding, ResolvedPage, ResolvedEntity, ResolvedTrait, ResolvedIR, OrbitalSchema, PatternConfig, ResolvedPatternProps, EventSource, SExpr, BusEventSource, EntityRow, EntityData } from '@almadar/core';
 export { ResolvedEntity, ResolvedIR, ResolvedPage, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
 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 } from '../EntityBindingContext-Bn3ePJQC.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-Bn3ePJQC.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';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-Czc2JAxo.js';
@@ -14,6 +15,7 @@ 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';
 
 interface TraitStateMachineResult {
     /** Current state for each trait */
@@ -95,6 +97,15 @@ interface UseTraitStateMachineOptions {
      * compiled-path codegen semantics.
      */
     embeddedTraits?: ReadonlySet<string>;
+    /**
+     * Referrer trait name → the DIRECT children (via `@trait.X`) that need
+     * their lifecycle transition re-run under the referrer's payload
+     * whenever the referrer's own transition fires — built by the caller
+     * via `@almadar/core`'s `collectCallsiteCaptureChildren` (merged across
+     * every orbital in the resolved schema, the same flattening
+     * `orbitalsByTrait` uses). See `reRenderCallsiteCaptureChildren`.
+     */
+    callsiteCaptureChildrenByTrait?: ReadonlyMap<string, ReadonlySet<string>>;
 }
 declare function useTraitStateMachine(traitBindings: ResolvedTraitBinding[], uiSlots: ReturnType<typeof useUISlots>, options?: UseTraitStateMachineOptions): TraitStateMachineResult;
 
@@ -149,7 +160,7 @@ declare function clearSchemaCache(): void;
  */
 interface SlotPatternEntry {
     pattern: PatternConfig;
-    props: Record<string, FieldValue | undefined>;
+    props: ResolvedPatternProps;
 }
 /**
  * The originating trait + state for a slot write. Embedded in the
@@ -177,7 +188,7 @@ interface ClientEventBus {
     emit: (type: string, payload?: EventPayload, source?: BusEventSource) => void;
 }
 interface SlotSetter {
-    addPattern: (slot: string, pattern: PatternConfig | null, props?: Record<string, FieldValue | undefined>) => void;
+    addPattern: (slot: string, pattern: PatternConfig | null, props?: ResolvedPatternProps) => void;
     clearSlot: (slot: string) => void;
 }
 interface CreateClientEffectHandlersOptions {
@@ -200,6 +211,17 @@ interface CreateClientEffectHandlersOptions {
      * and ticks — no guard-vs-render split.
      */
     liveEntity?: EntityRow;
+    /**
+     * Bridge mode — no local persistence adapter is wired, so the SERVER
+     * executes every persist and returns its outcome. Sets
+     * `EffectHandlers.persistDelegated` so the executor skips the placeholder
+     * `persist` below instead of reading its `undefined` as a denial
+     * (an error in every browser console + a client-side `failure` emit
+     * while the server had succeeded). The hook decides this from whether a
+     * `persistence` adapter was supplied — `liveEntity` says nothing about
+     * it (the hook always binds one for `(set @entity.X)`).
+     */
+    persistDelegated?: boolean;
     /**
      * Optional consumer-supplied call-service handler. When set, it runs
      * instead of the default mock fallback — use to wire the playground
@@ -246,6 +268,8 @@ interface OrbPreviewProps {
      * `OrbitalServerRuntime.processOrbitalEvent` directly without HTTP.
      */
     transport?: ServerBridgeTransport;
+    /** Bearer token for `serverUrl` requests (see `ServerBridgeProviderProps.getAccessToken`). */
+    getAccessToken?: AccessTokenProvider;
     /**
      * Initial page path to render (e.g. `/deals`). Resolves against the
      * schema's `pages[]` to seed `currentPage` so the right orbital's traits
@@ -275,7 +299,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, initialPagePath, isolated, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }
@@ -418,4 +442,4 @@ declare function useOrbitalPluginHost(): {
  */
 declare function OrbitalPluginHost({ plugins, mode, transport, deny, navigate, notify, onTransition, children, }: OrbitalPluginHostProps): React__default.ReactElement;
 
-export { 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 };
+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 };