@almadar/ui 2.61.1 → 3.0.1

package/dist/runtime/index.cjs

@@ -34,8 +34,8 @@ var langDiff = require('react-syntax-highlighter/dist/esm/languages/prism/diff.j
 var langToml = require('react-syntax-highlighter/dist/esm/languages/prism/toml.js');
 var langGo = require('react-syntax-highlighter/dist/esm/languages/prism/go.js');
 var langGraphql = require('react-syntax-highlighter/dist/esm/languages/prism/graphql.js');
-require('@tanstack/react-query');
 var core = require('@almadar/core');
+require('@tanstack/react-query');
 var runtime = require('@almadar/runtime');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -10409,9 +10409,9 @@ var init_ScaledDiagram = __esm({
   }
 });
 
-// node_modules/.pnpm/katex@0.16.33/node_modules/katex/dist/katex.min.css
+// node_modules/.pnpm/katex@0.16.45/node_modules/katex/dist/katex.min.css
 var init_katex_min = __esm({
-  "node_modules/.pnpm/katex@0.16.33/node_modules/katex/dist/katex.min.css"() {
+  "node_modules/.pnpm/katex@0.16.45/node_modules/katex/dist/katex.min.css"() {
   }
 });
 var MarkdownContent;
@@ -12410,7 +12410,9 @@ function extractTrait(schema, trait, traitIndex) {
   for (const orbital of schema.orbitals) {
     const traits2 = orbital.traits ?? [];
     if (traitIndex < traits2.length) {
-      return traits2[traitIndex];
+      const traitRef = traits2[traitIndex];
+      if (core.isInlineTrait(traitRef)) return traitRef;
+      return null;
     }
   }
   return null;
@@ -12418,8 +12420,10 @@ function extractTrait(schema, trait, traitIndex) {
 function extractEntityFields(schema) {
   if (!schema?.orbitals?.length) return [];
   const entity = schema.orbitals[0].entity;
-  if (!entity?.fields) return [];
-  return entity.fields.map((f3) => f3.name);
+  if (!entity || typeof entity !== "object" || !("fields" in entity)) return [];
+  const inlineEntity = entity;
+  if (!inlineEntity.fields) return [];
+  return inlineEntity.fields.map((f3) => f3.name);
 }
 function toStateMachineDefinition(sm) {
   return {
@@ -12714,12 +12718,18 @@ var init_ContentRenderer = __esm({
             );
           case "orbital": {
             const parsed = segment.schema;
+            const inlineTrait = {
+              name: "inline",
+              scope: "instance",
+              stateMachine: parsed
+            };
             const schema = Array.isArray(parsed.orbitals) ? parsed : {
+              name: "inline",
               orbitals: [{
-                traits: [{
-                  name: "inline",
-                  stateMachine: parsed
-                }]
+                name: "inline",
+                entity: { name: "inline", fields: [] },
+                traits: [inlineTrait],
+                pages: []
               }]
             };
             return /* @__PURE__ */ jsxRuntime.jsxs(VStack, { gap: "sm", children: [
@@ -37574,19 +37584,15 @@ function SlotContentRenderer({
   patternPath
 }) {
   const entityProp = content.props.entity;
-  const entityType = typeof entityProp === "string" ? entityProp : "";
-  const storeData = providers.useEntityRef(entityType);
-  React116__namespace.default.useEffect(() => {
-    if (!entityType) return;
-    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
-    if (STRING_ENTITY_WARNED.has(entityType)) return;
-    STRING_ENTITY_WARNED.add(entityType);
-    console.warn(
-      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
-    );
-  }, [entityType]);
+  if (typeof entityProp === "string" && entityProp.length > 0) {
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV !== "production") {
+      throw new Error(
+        `[UISlotRenderer] Received string 'entity: "${entityProp}"' at render time. The V2 flow requires pre-resolved data; declare a fetch success listener and pass 'entity: @payload.data'. See docs/Almadar_Entity_V2_Plan.md \xA76.`
+      );
+    }
+  }
   const schemaCtx = useEntitySchemaOptional();
-  const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
+  const entityDef = typeof entityProp === "string" && entityProp.length > 0 && schemaCtx ? schemaCtx.entities.get(entityProp) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
   if (PatternComponent) {
     const childrenConfig = content.props.children;
@@ -37595,12 +37601,7 @@ function SlotContentRenderer({
     const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath) : void 0;
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
-    let finalProps;
-    if (entityType) {
-      finalProps = { ...renderedProps, entity: storeData };
-    } else {
-      finalProps = renderedProps;
-    }
+    const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
     ) ? finalProps.entity : null;
@@ -37614,9 +37615,6 @@ function SlotContentRenderer({
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
-      if (finalProps.mode === "edit" && !finalProps.initialData && storeData.length > 0) {
-        finalProps.initialData = storeData[0];
-      }
     }
     const acceptsChildren = PATTERNS_WITH_CHILDREN.has(content.pattern);
     return /* @__PURE__ */ jsxRuntime.jsx(
@@ -37710,7 +37708,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37727,7 +37725,6 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
-    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = React116.createContext({ enabled: false });
     SlotContainedContext = React116.createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";
@@ -38555,7 +38552,7 @@ function buildMockData(schema) {
   }
   return result;
 }
-function isInlineTrait(traitRef) {
+function isInlineTrait2(traitRef) {
   return typeof traitRef === "object" && traitRef !== null && "stateMachine" in traitRef;
 }
 function findDataState(sm, initialStateName) {
@@ -38587,7 +38584,7 @@ function adjustSchemaForMockData(schema, mockData) {
   const updatedOrbitals = schema.orbitals.map((orbital) => {
     const traits2 = orbital.traits ?? [];
     const updatedTraits = traits2.map((traitRef) => {
-      if (!isInlineTrait(traitRef)) return traitRef;
+      if (!isInlineTrait2(traitRef)) return traitRef;
       const updated = rewriteTraitInitialState(traitRef, mockData);
       if (updated !== traitRef) changed = true;
       return updated;
@@ -38665,23 +38662,14 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = context.useUISlots();
-  const entityStore = providers.useEntityStore();
   const onEventProcessed = React116.useCallback(async (event, payload) => {
     if (!bridge.connected || !orbitalNames?.length) return;
     for (const name of orbitalNames) {
       const { effects, meta } = await bridge.sendEvent(name, event, payload);
       recordServerResponse(name, event, meta);
-      const responseData = meta?.data;
-      if (responseData) {
-        for (const [entityType, records] of Object.entries(responseData)) {
-          if (Array.isArray(records)) {
-            entityStore.setAll(entityType, records);
-          }
-        }
-      }
       applyServerEffects(effects, uiSlots, onNavigate);
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, entityStore]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate } : { navigate: onNavigate };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = React116.useRef(false);
@@ -38721,14 +38709,6 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
           effects: effectTraces,
           timestamp: Date.now()
         });
-        const initResponseData = meta?.data;
-        if (initResponseData) {
-          for (const [entityType, records] of Object.entries(initResponseData)) {
-            if (Array.isArray(records)) {
-              entityStore.setAll(entityType, records);
-            }
-          }
-        }
         applyServerEffects(effects, uiSlots, onNavigate);
       }
     })();
@@ -38761,19 +38741,6 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
-  const entityStore = providers.useEntityStore();
-  const seededRef = React116.useRef("");
-  const mockKey = mockData ? Object.keys(mockData).sort().join(",") : "";
-  React116__namespace.default.useLayoutEffect(() => {
-    if (!serverUrl && mockData && seededRef.current !== mockKey) {
-      seededRef.current = mockKey;
-      for (const [entityType, records] of Object.entries(mockData)) {
-        if (Array.isArray(records)) {
-          entityStore.setAll(entityType, records);
-        }
-      }
-    }
-  }, [mockKey, serverUrl, mockData, entityStore]);
   const inner = /* @__PURE__ */ jsxRuntime.jsx(providers.VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
     /* @__PURE__ */ jsxRuntime.jsx(
       TraitInitializer,

package/dist/runtime/index.css

@@ -1,4 +1,4 @@
-/* node_modules/.pnpm/katex@0.16.33/node_modules/katex/dist/katex.min.css */
+/* node_modules/.pnpm/katex@0.16.45/node_modules/katex/dist/katex.min.css */
 @font-face {
   font-display: block;
   font-family: KaTeX_AMS;
@@ -205,6 +205,7 @@
     Times New Roman,
     serif;
   line-height: 1.2;
+  position: relative;
   text-indent: 0;
   text-rendering: auto;
 }
@@ -213,7 +214,7 @@
   border-color: currentColor;
 }
 .katex .katex-version:after {
-  content: "0.16.33";
+  content: "0.16.45";
 }
 .katex .katex-mathml {
   clip: rect(1px, 1px, 1px, 1px);
@@ -389,6 +390,10 @@
 .katex .mspace {
   display: inline-block;
 }
+.katex .smash {
+  display: inline;
+  line-height: 0;
+}
 .katex .clap,
 .katex .llap,
 .katex .rlap {

package/dist/runtime/index.js

@@ -1,6 +1,6 @@
 import * as React116 from 'react';
 import React116__default, { createContext, useContext, useRef, useEffect, useCallback, useMemo, Suspense, useState, useLayoutEffect, lazy, useId } from 'react';
-import { EventBusContext, useEntityRef, OrbitalProvider, useEntityStore, VerificationProvider } from '@almadar/ui/providers';
+import { EventBusContext, OrbitalProvider, VerificationProvider } from '@almadar/ui/providers';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
@@ -34,8 +34,8 @@ import langDiff from 'react-syntax-highlighter/dist/esm/languages/prism/diff.js'
 import langToml from 'react-syntax-highlighter/dist/esm/languages/prism/toml.js';
 import langGo from 'react-syntax-highlighter/dist/esm/languages/prism/go.js';
 import langGraphql from 'react-syntax-highlighter/dist/esm/languages/prism/graphql.js';
+import { isCircuitEvent, schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1, isEntityCall, isInlineTrait } from '@almadar/core';
 import '@tanstack/react-query';
-import { isCircuitEvent, schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1, isEntityCall } from '@almadar/core';
 import { StateMachineManager, createContextFromBindings, interpolateValue, EffectExecutor } from '@almadar/runtime';
 
 var __defProp = Object.defineProperty;
@@ -10364,9 +10364,9 @@ var init_ScaledDiagram = __esm({
   }
 });
 
-// node_modules/.pnpm/katex@0.16.33/node_modules/katex/dist/katex.min.css
+// node_modules/.pnpm/katex@0.16.45/node_modules/katex/dist/katex.min.css
 var init_katex_min = __esm({
-  "node_modules/.pnpm/katex@0.16.33/node_modules/katex/dist/katex.min.css"() {
+  "node_modules/.pnpm/katex@0.16.45/node_modules/katex/dist/katex.min.css"() {
   }
 });
 var MarkdownContent;
@@ -12365,7 +12365,9 @@ function extractTrait(schema, trait, traitIndex) {
   for (const orbital of schema.orbitals) {
     const traits2 = orbital.traits ?? [];
     if (traitIndex < traits2.length) {
-      return traits2[traitIndex];
+      const traitRef = traits2[traitIndex];
+      if (isInlineTrait(traitRef)) return traitRef;
+      return null;
     }
   }
   return null;
@@ -12373,8 +12375,10 @@ function extractTrait(schema, trait, traitIndex) {
 function extractEntityFields(schema) {
   if (!schema?.orbitals?.length) return [];
   const entity = schema.orbitals[0].entity;
-  if (!entity?.fields) return [];
-  return entity.fields.map((f3) => f3.name);
+  if (!entity || typeof entity !== "object" || !("fields" in entity)) return [];
+  const inlineEntity = entity;
+  if (!inlineEntity.fields) return [];
+  return inlineEntity.fields.map((f3) => f3.name);
 }
 function toStateMachineDefinition(sm) {
   return {
@@ -12669,12 +12673,18 @@ var init_ContentRenderer = __esm({
             );
           case "orbital": {
             const parsed = segment.schema;
+            const inlineTrait = {
+              name: "inline",
+              scope: "instance",
+              stateMachine: parsed
+            };
             const schema = Array.isArray(parsed.orbitals) ? parsed : {
+              name: "inline",
               orbitals: [{
-                traits: [{
-                  name: "inline",
-                  stateMachine: parsed
-                }]
+                name: "inline",
+                entity: { name: "inline", fields: [] },
+                traits: [inlineTrait],
+                pages: []
               }]
             };
             return /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
@@ -37529,19 +37539,15 @@ function SlotContentRenderer({
   patternPath
 }) {
   const entityProp = content.props.entity;
-  const entityType = typeof entityProp === "string" ? entityProp : "";
-  const storeData = useEntityRef(entityType);
-  React116__default.useEffect(() => {
-    if (!entityType) return;
-    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV === "production") return;
-    if (STRING_ENTITY_WARNED.has(entityType)) return;
-    STRING_ENTITY_WARNED.add(entityType);
-    console.warn(
-      `[UISlotRenderer] String-entity binding '${entityType}' is deprecated. Pass 'items' or 'entity' as a value prop resolved from @payload.data. See docs/Almadar_Entity_V2_Plan.md \xA75.`
-    );
-  }, [entityType]);
+  if (typeof entityProp === "string" && entityProp.length > 0) {
+    if (typeof process !== "undefined" && process.env && process.env.NODE_ENV !== "production") {
+      throw new Error(
+        `[UISlotRenderer] Received string 'entity: "${entityProp}"' at render time. The V2 flow requires pre-resolved data; declare a fetch success listener and pass 'entity: @payload.data'. See docs/Almadar_Entity_V2_Plan.md \xA76.`
+      );
+    }
+  }
   const schemaCtx = useEntitySchemaOptional();
-  const entityDef = entityType && schemaCtx ? schemaCtx.entities.get(entityType) : void 0;
+  const entityDef = typeof entityProp === "string" && entityProp.length > 0 && schemaCtx ? schemaCtx.entities.get(entityProp) : void 0;
   const PatternComponent = getComponentForPattern(content.pattern);
   if (PatternComponent) {
     const childrenConfig = content.props.children;
@@ -37550,12 +37556,7 @@ function SlotContentRenderer({
     const renderedChildren = hasChildren ? renderPatternChildren(childrenConfig, onDismiss, content.id, myPath) : void 0;
     const { children: _childrenConfig, ...restProps } = content.props;
     const renderedProps = renderPatternProps(restProps, onDismiss);
-    let finalProps;
-    if (entityType) {
-      finalProps = { ...renderedProps, entity: storeData };
-    } else {
-      finalProps = renderedProps;
-    }
+    const finalProps = renderedProps;
     const resolvedItems = Array.isArray(
       finalProps.entity
     ) ? finalProps.entity : null;
@@ -37569,9 +37570,6 @@ function SlotContentRenderer({
     const isFormPattern = FORM_PATTERNS.has(content.pattern) || content.pattern.includes("form");
     if (isFormPattern && entityDef && Array.isArray(finalProps.fields)) {
       finalProps.fields = enrichFormFields(finalProps.fields, entityDef);
-      if (finalProps.mode === "edit" && !finalProps.initialData && storeData.length > 0) {
-        finalProps.initialData = storeData[0];
-      }
     }
     const acceptsChildren = PATTERNS_WITH_CHILDREN.has(content.pattern);
     return /* @__PURE__ */ jsx(
@@ -37665,7 +37663,7 @@ function UISlotRenderer({
   }
   return wrapped;
 }
-var TRAIT_BINDING_RE, STRING_ENTITY_WARNED, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
+var TRAIT_BINDING_RE, SuspenseConfigContext, SlotContainedContext, SLOT_SKELETON_MAP, FORM_PATTERNS, PATTERNS_WITH_CHILDREN;
 var init_UISlotRenderer = __esm({
   "components/organisms/UISlotRenderer.tsx"() {
     "use client";
@@ -37682,7 +37680,6 @@ var init_UISlotRenderer = __esm({
     init_TraitFrame();
     init_component_registry_generated();
     TRAIT_BINDING_RE = /^@trait\.([A-Z][A-Za-z0-9]*)$/;
-    STRING_ENTITY_WARNED = /* @__PURE__ */ new Set();
     SuspenseConfigContext = createContext({ enabled: false });
     SlotContainedContext = createContext(false);
     SuspenseConfigProvider.displayName = "SuspenseConfigProvider";
@@ -38510,7 +38507,7 @@ function buildMockData(schema) {
   }
   return result;
 }
-function isInlineTrait(traitRef) {
+function isInlineTrait2(traitRef) {
   return typeof traitRef === "object" && traitRef !== null && "stateMachine" in traitRef;
 }
 function findDataState(sm, initialStateName) {
@@ -38542,7 +38539,7 @@ function adjustSchemaForMockData(schema, mockData) {
   const updatedOrbitals = schema.orbitals.map((orbital) => {
     const traits2 = orbital.traits ?? [];
     const updatedTraits = traits2.map((traitRef) => {
-      if (!isInlineTrait(traitRef)) return traitRef;
+      if (!isInlineTrait2(traitRef)) return traitRef;
       const updated = rewriteTraitInitialState(traitRef, mockData);
       if (updated !== traitRef) changed = true;
       return updated;
@@ -38620,23 +38617,14 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = useUISlots();
-  const entityStore = useEntityStore();
   const onEventProcessed = useCallback(async (event, payload) => {
     if (!bridge.connected || !orbitalNames?.length) return;
     for (const name of orbitalNames) {
       const { effects, meta } = await bridge.sendEvent(name, event, payload);
       recordServerResponse(name, event, meta);
-      const responseData = meta?.data;
-      if (responseData) {
-        for (const [entityType, records] of Object.entries(responseData)) {
-          if (Array.isArray(records)) {
-            entityStore.setAll(entityType, records);
-          }
-        }
-      }
       applyServerEffects(effects, uiSlots, onNavigate);
     }
-  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate, entityStore]);
+  }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
   const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate } : { navigate: onNavigate };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = useRef(false);
@@ -38676,14 +38664,6 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
           effects: effectTraces,
           timestamp: Date.now()
         });
-        const initResponseData = meta?.data;
-        if (initResponseData) {
-          for (const [entityType, records] of Object.entries(initResponseData)) {
-            if (Array.isArray(records)) {
-              entityStore.setAll(entityType, records);
-            }
-          }
-        }
         applyServerEffects(effects, uiSlots, onNavigate);
       }
     })();
@@ -38716,19 +38696,6 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
-  const entityStore = useEntityStore();
-  const seededRef = useRef("");
-  const mockKey = mockData ? Object.keys(mockData).sort().join(",") : "";
-  React116__default.useLayoutEffect(() => {
-    if (!serverUrl && mockData && seededRef.current !== mockKey) {
-      seededRef.current = mockKey;
-      for (const [entityType, records] of Object.entries(mockData)) {
-        if (Array.isArray(records)) {
-          entityStore.setAll(entityType, records);
-        }
-      }
-    }
-  }, [mockKey, serverUrl, mockData, entityStore]);
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(SlotsProvider, { children: /* @__PURE__ */ jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
     /* @__PURE__ */ jsx(
       TraitInitializer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.61.1",
+  "version": "3.0.1",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",
@@ -118,10 +118,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": ">=4.8.2",
+    "@almadar/core": ">=5.1.0",
     "@almadar/evaluator": ">=2.8.1",
     "@almadar/patterns": ">=2.14.1",
-    "@almadar/runtime": ">=3.2.6",
+    "@almadar/runtime": ">=4.0.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@xyflow/react": "12.10.1",

package/dist/providers/EntityStoreProvider.d.ts

@@ -1,63 +0,0 @@
-/**
- * EntityStoreProvider
- *
- * Normalized reactive entity store for Orbital applications.
- * Stores entities in ID-keyed Maps with ordered ID lists.
- * Provides operation-specific methods (setAll, upsertOne, addOne,
- * updateOne, removeOne) and selector hooks (useEntityRef for
- * collections, useEntityById for single entities).
- *
- * Every mutation creates new Map/array objects (immutable values).
- * Identity (the store key) advances to a new value on each write.
- * Follows the Clojure epochal time model from Almadar_Orb_IO.md.
- *
- * @packageDocumentation
- */
-import React, { type ReactNode } from 'react';
-type StoreListener = () => void;
-type WatchCallback = (oldData: unknown[], newData: unknown[]) => void;
-export declare function subscribeToStore(listener: StoreListener): () => void;
-/**
- * Subscribe to an entity collection reactively.
- * Returns the full ordered array. Re-renders when the collection changes.
- *
- * Client-side implementation of `["ref", "EntityType"]`.
- */
-export declare function useEntityRef(entityType: string): unknown[];
-/**
- * Subscribe to a single entity by ID reactively.
- * Returns the entity record or null. Re-renders when the entity changes.
- *
- * Client-side implementation of `["fetch", "EntityType", { id: ... }]`.
- */
-export declare function useEntityById(entityType: string, id: string | undefined): Record<string, unknown> | null;
-/**
- * Register a callback that fires when an entity collection changes.
- * Receives (oldData, newData) for side effects (notify, emit, log).
- *
- * Client-side implementation of `["watch", "EntityType", effects]`.
- */
-export declare function useEntityWatch(entityType: string, callback: WatchCallback): void;
-export interface EntityStoreContextValue {
-    setAll: (entityType: string, records: unknown[]) => void;
-    upsertOne: (entityType: string, record: Record<string, unknown>) => void;
-    addOne: (entityType: string, record: Record<string, unknown>) => void;
-    updateOne: (entityType: string, id: string, changes: Partial<Record<string, unknown>>) => void;
-    removeOne: (entityType: string, id: string) => void;
-    getSnapshot: (entityType: string) => unknown[];
-    getById: (entityType: string, id: string) => Record<string, unknown> | null;
-}
-export declare const EntityStoreContext: React.Context<EntityStoreContextValue>;
-/**
- * Access the entity store operations.
- * Used by useOrbitalBridge and OrbPreview to push server response data into the store.
- */
-export declare function useEntityStore(): EntityStoreContextValue;
-/**
- * Provider component. Wrap the app or page with this to enable entity reactivity.
- * Already included in OrbitalProvider.
- */
-export declare function EntityStoreProvider({ children }: {
-    children: ReactNode;
-}): React.ReactElement;
-export {};