@almadar/evaluator 2.43.0 → 2.45.0

package/dist/{index-DY9A18IY.d.ts → index-DmefVNGd.d.ts}

@@ -18,6 +18,18 @@ interface EvaluationContext {
     entity: EntityRow;
     /** Payload data for @payload bindings */
     payload: EventPayload;
+    /**
+     * The composing effect's triggering payload, for a trait embedded via
+     * `@trait.X` inline into a parent's render-ui. The lolo lowerer hoists a
+     * JSX render site's `?field` reads into the embedded child's config as
+     * `@callsitePayload.<field>` — mirrors the compiled path's
+     * `CALLSITE_PAYLOAD_PREFIX` (`orbital-core/src/schema/types.rs`) and
+     * `@almadar/core`'s `CORE_BINDINGS` root `callsitePayload`. Set by
+     * `OrbitalServerRuntime.executeEffects` / the client's
+     * `useTraitStateMachine` when re-running an embedded child's lifecycle
+     * transition under its embedder's payload.
+     */
+    callsitePayload?: EventPayload;
     /** Current state for @state binding */
     state: string;
     /** Current timestamp for @now binding (defaults to Date.now()) */
@@ -343,7 +355,10 @@ declare function evalLast(args: SExpr[], evaluate: Evaluator$2, ctx: EvaluationC
  */
 declare function evalNth(args: SExpr[], evaluate: Evaluator$2, ctx: EvaluationContext): RuntimeValue;
 /**
- * Evaluate concat: ["concat", collection1, collection2, ...]
+ * Array-concat semantics for a collection of args. Not wired to any bare
+ * "concat" S-expr head (removed as an ambiguous alias — use 'array/concat'
+ * or std/array.ts's evalArrayConcat, which is what "array/concat" dispatches
+ * to); kept as a plain exported utility.
  */
 declare function evalConcat(args: SExpr[], evaluate: Evaluator$2, ctx: EvaluationContext): RuntimeValue[];
 /**

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { SExpr, RuntimeValue, ListenPayloadEvaluator } from '@almadar/core';
 export { CORE_BINDINGS, CoreBinding, Expression, ExpressionSchema, ParsedBinding, SExpr, SExprAtom, SExprSchema, UserContext, collectBindings, getArgs, getOperator, isBinding, isSExpr, isSExprAtom, isSExprCall, isValidBinding, parseBinding, sexpr, walkSExpr } from '@almadar/core';
-import { E as EvaluationContext } from './index-DY9A18IY.js';
-export { c as createChildContext, a as createEffectContext, b as createMinimalContext, e as evalAbs, d as evalAdd, f as evalAnd, g as evalAtomic, h as evalCallService, i as evalCeil, j as evalClamp, k as evalConcat, l as evalCount, m as evalDecrement, n as evalDeref, o as evalDespawn, p as evalDivide, q as evalDo, r as evalEmit, s as evalEmpty, t as evalEqual, u as evalFilter, v as evalFind, w as evalFirst, x as evalFloor, y as evalFn, z as evalGreaterThan, A as evalGreaterThanOrEqual, B as evalIf, C as evalIncludes, D as evalIncrement, F as evalLast, G as evalLessThan, H as evalLessThanOrEqual, I as evalLet, J as evalList, K as evalMap, L as evalMatches, M as evalMax, N as evalMin, O as evalModulo, P as evalMultiply, Q as evalNavigate, R as evalNot, S as evalNotEqual, T as evalNotify, U as evalNth, V as evalOr, W as evalPersist, X as evalRef, Y as evalRenderUI, Z as evalRound, _ as evalSet, $ as evalSetDynamic, a0 as evalSpawn, a1 as evalSubtract, a2 as evalSum, a3 as evalSwap, a4 as evalWatch, a5 as evalWhen, a6 as resolveBinding } from './index-DY9A18IY.js';
+import { E as EvaluationContext } from './index-DmefVNGd.js';
+export { c as createChildContext, a as createEffectContext, b as createMinimalContext, e as evalAbs, d as evalAdd, f as evalAnd, g as evalAtomic, h as evalCallService, i as evalCeil, j as evalClamp, k as evalConcat, l as evalCount, m as evalDecrement, n as evalDeref, o as evalDespawn, p as evalDivide, q as evalDo, r as evalEmit, s as evalEmpty, t as evalEqual, u as evalFilter, v as evalFind, w as evalFirst, x as evalFloor, y as evalFn, z as evalGreaterThan, A as evalGreaterThanOrEqual, B as evalIf, C as evalIncludes, D as evalIncrement, F as evalLast, G as evalLessThan, H as evalLessThanOrEqual, I as evalLet, J as evalList, K as evalMap, L as evalMatches, M as evalMax, N as evalMin, O as evalModulo, P as evalMultiply, Q as evalNavigate, R as evalNot, S as evalNotEqual, T as evalNotify, U as evalNth, V as evalOr, W as evalPersist, X as evalRef, Y as evalRenderUI, Z as evalRound, _ as evalSet, $ as evalSetDynamic, a0 as evalSpawn, a1 as evalSubtract, a2 as evalSum, a3 as evalSwap, a4 as evalWatch, a5 as evalWhen, a6 as resolveBinding } from './index-DmefVNGd.js';
 
 /**
  * S-Expression Evaluator

package/dist/index.js

@@ -63,6 +63,9 @@ function resolveBinding(binding, ctx) {
       case "payload":
         value = ctx.payload;
         break;
+      case "callsitePayload":
+        value = ctx.callsitePayload;
+        break;
       case "state":
         return ctx.state;
       // @state has no path
@@ -1035,10 +1038,6 @@ function evalArrayRange(args, evaluate2, ctx) {
   }
   return out;
 }
-function evalArrayEmpty(args, evaluate2, ctx) {
-  const arr = evaluate2(args[0], ctx);
-  return !arr || arr.length === 0;
-}
 function evalArrayFirst(args, evaluate2, ctx) {
   const arr = evaluate2(args[0], ctx);
   return arr?.[0] ?? null;
@@ -1526,10 +1525,6 @@ function evalObjectFilter(args, evaluate2, ctx) {
   }
   return result;
 }
-function evalObjectEmpty(args, evaluate2, ctx) {
-  const obj = evaluate2(args[0], ctx);
-  return !obj || Object.keys(obj).length === 0;
-}
 function evalObjectEquals(args, evaluate2, ctx) {
   const a = evaluate2(args[0], ctx);
   const b = evaluate2(args[1], ctx);
@@ -4163,6 +4158,13 @@ function evalPathReachable(args, evaluate2, ctx) {
 
 // SExpressionEvaluator.ts
 var UNKNOWN_OPERATOR = /* @__PURE__ */ Symbol("unknown-operator");
+function assertNotAmbiguousConcat(op) {
+  if (op === "concat") {
+    throw new Error(
+      "Ambiguous operator 'concat': use 'str/concat' (string) or 'array/concat' (array)"
+    );
+  }
+}
 var OPERATOR_TABLE = {
   "+": evalAdd,
   "-": evalSubtract,
@@ -4201,7 +4203,6 @@ var OPERATOR_TABLE = {
   "first": evalFirst,
   "last": evalLast,
   "nth": evalNth,
-  "concat": evalConcat,
   "includes": evalIncludes,
   "empty": evalEmpty,
   "list": evalList,
@@ -4360,7 +4361,6 @@ var OPERATOR_TABLE = {
   "to-string": (args, evaluate2, ctx) => String(evaluate2(args[0], ctx)),
   "array/len": evalArrayLen,
   "array/range": evalArrayRange,
-  "array/empty?": evalArrayEmpty,
   "array/first": evalArrayFirst,
   "array/last": evalArrayLast,
   "array/nth": evalArrayNth,
@@ -4414,7 +4414,6 @@ var OPERATOR_TABLE = {
   "object/mapValues": evalObjectMapValues,
   "object/mapKeys": evalObjectMapKeys,
   "object/filter": evalObjectFilter,
-  "object/empty?": evalObjectEmpty,
   "object/equals": evalObjectEquals,
   "object/clone": evalObjectClone,
   "object/deepClone": evalObjectDeepClone,
@@ -4705,6 +4704,7 @@ var SExpressionEvaluator = class {
     } else {
       const op = getOperator(expr);
       const args = getArgs(expr);
+      assertNotAmbiguousConcat(op);
       assertOperatorArity(op, args.length);
       const impl = OPERATOR_TABLE[op];
       for (const item of expr) {
@@ -4787,6 +4787,7 @@ var SExpressionEvaluator = class {
    * Dispatch to the appropriate operator implementation.
    */
   dispatchOperator(op, args, ctx) {
+    assertNotAmbiguousConcat(op);
     assertOperatorArity(op, args.length);
     const impl = OPERATOR_TABLE[op];
     if (impl === void 0) return UNKNOWN_OPERATOR;