@almadar/ui 6.10.0 → 6.12.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, A as AccessTokenProvider } from '../EntityBindingContext-Y4zXyNJZ.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-Y4zXyNJZ.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

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, A as AccessTokenProvider } from '../EntityBindingContext-Y4zXyNJZ.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-Y4zXyNJZ.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