@almadar/ui 5.135.0 → 5.136.0

package/dist/{TraitProvider-Ch79cUcb.d.cts → EntityBindingContext-CD9ZoXb4.d.cts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
+import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
 
 /**
@@ -238,4 +238,32 @@ declare function useTraitContext(): TraitContextValue;
  */
 declare function useTrait(traitName: string): TraitInstance | undefined;
 
-export { type EntitySchemaContextValue as E, type SendEventResult as S, TraitContext as T, EntitySchemaProvider as a, type EntitySchemaProviderProps as b, type ServerBridgeContextValue as c, ServerBridgeProvider as d, type ServerBridgeProviderProps as e, type ServerBridgeTransport as f, type ServerClientEffect as g, type ServerResponseMeta as h, type TraitContextValue as i, type TraitInstance as j, TraitProvider as k, type TraitProviderProps as l, useEntitySchemaOptional as m, useServerBridge as n, useTrait as o, useTraitContext as p, useEntitySchema as u };
+/**
+ * Read + subscribe surface over the live trait binding stores. Snapshots
+ * are cached objects — a new reference only when the trait's entity
+ * actually changed (the `useSyncExternalStore` contract).
+ */
+interface EntityBindingSource {
+    /** Current entity snapshot for a trait (shared-entity traits read the shared store). */
+    getEntitySnapshot: (traitName: string) => EntityRow;
+    /** Merged render-time config (declared defaults < resolved < call-site). */
+    getConfig: (traitName: string) => TraitConfig | undefined;
+    /** Current state-machine state — evaluation context for `@state` in marked expressions. */
+    getState: (traitName: string) => string;
+    /** Subscribe to entity commits for a trait. Returns unsubscribe. */
+    subscribe: (traitName: string, callback: () => void) => () => void;
+}
+declare const EntityBindingContext: React.Context<EntityBindingSource | null>;
+/**
+ * Bridge one trait's live bindings into React. With no provider (compiled
+ * shell, static renders) or no owning trait, returns empty bindings and
+ * never re-renders — markers resolve to the same `undefined` they would
+ * have resolved to at flush time against an empty entity.
+ */
+declare function useEntityBindingSnapshot(traitName: string | undefined): {
+    entity: EntityRow;
+    config: TraitConfig | undefined;
+    state: string;
+};
+
+export { EntityBindingContext as E, type SendEventResult as S, TraitContext as T, type EntityBindingSource as a, type EntitySchemaContextValue as b, EntitySchemaProvider as c, type EntitySchemaProviderProps as d, type ServerBridgeContextValue as e, ServerBridgeProvider as f, type ServerBridgeProviderProps as g, type ServerBridgeTransport as h, type ServerClientEffect as i, type ServerResponseMeta as j, type TraitContextValue as k, type TraitInstance as l, TraitProvider as m, type TraitProviderProps as n, useEntitySchema as o, useEntitySchemaOptional as p, useServerBridge as q, useTrait as r, useTraitContext as s, useEntityBindingSnapshot as u };

package/dist/{TraitProvider-Ch79cUcb.d.ts → EntityBindingContext-CD9ZoXb4.d.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import React__default, { ReactNode } from 'react';
-import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding } from '@almadar/core';
+import { ResolvedEntity, EventPayload, EntityRow, OrbitalSchema, BusEventSource, SExpr, ResolvedTrait, ResolvedTraitBinding, TraitConfig } from '@almadar/core';
 import { AnyPatternConfig } from '@almadar/core/patterns';
 
 /**
@@ -238,4 +238,32 @@ declare function useTraitContext(): TraitContextValue;
  */
 declare function useTrait(traitName: string): TraitInstance | undefined;
 
-export { type EntitySchemaContextValue as E, type SendEventResult as S, TraitContext as T, EntitySchemaProvider as a, type EntitySchemaProviderProps as b, type ServerBridgeContextValue as c, ServerBridgeProvider as d, type ServerBridgeProviderProps as e, type ServerBridgeTransport as f, type ServerClientEffect as g, type ServerResponseMeta as h, type TraitContextValue as i, type TraitInstance as j, TraitProvider as k, type TraitProviderProps as l, useEntitySchemaOptional as m, useServerBridge as n, useTrait as o, useTraitContext as p, useEntitySchema as u };
+/**
+ * Read + subscribe surface over the live trait binding stores. Snapshots
+ * are cached objects — a new reference only when the trait's entity
+ * actually changed (the `useSyncExternalStore` contract).
+ */
+interface EntityBindingSource {
+    /** Current entity snapshot for a trait (shared-entity traits read the shared store). */
+    getEntitySnapshot: (traitName: string) => EntityRow;
+    /** Merged render-time config (declared defaults < resolved < call-site). */
+    getConfig: (traitName: string) => TraitConfig | undefined;
+    /** Current state-machine state — evaluation context for `@state` in marked expressions. */
+    getState: (traitName: string) => string;
+    /** Subscribe to entity commits for a trait. Returns unsubscribe. */
+    subscribe: (traitName: string, callback: () => void) => () => void;
+}
+declare const EntityBindingContext: React.Context<EntityBindingSource | null>;
+/**
+ * Bridge one trait's live bindings into React. With no provider (compiled
+ * shell, static renders) or no owning trait, returns empty bindings and
+ * never re-renders — markers resolve to the same `undefined` they would
+ * have resolved to at flush time against an empty entity.
+ */
+declare function useEntityBindingSnapshot(traitName: string | undefined): {
+    entity: EntityRow;
+    config: TraitConfig | undefined;
+    state: string;
+};
+
+export { EntityBindingContext as E, type SendEventResult as S, TraitContext as T, type EntityBindingSource as a, type EntitySchemaContextValue as b, EntitySchemaProvider as c, type EntitySchemaProviderProps as d, type ServerBridgeContextValue as e, ServerBridgeProvider as f, type ServerBridgeProviderProps as g, type ServerBridgeTransport as h, type ServerClientEffect as i, type ServerResponseMeta as j, type TraitContextValue as k, type TraitInstance as l, TraitProvider as m, type TraitProviderProps as n, useEntitySchema as o, useEntitySchemaOptional as p, useServerBridge as q, useTrait as r, useTraitContext as s, useEntityBindingSnapshot as u };