@almadar/evaluator 1.0.0 → 1.0.9

package/dist/{index-BBb9Y3Sp.d.ts → index-DsM_--K3.d.ts}

@@ -1,145 +1,4 @@
-import { z } from 'zod';
-
-/**
- * S-Expression Types
- *
- * Defines the S-Expression type system for guards, effects, and computed values.
- * S-expressions are JSON arrays where the first element is an operator string.
- *
- * @example
- * // Guard: health > 0
- * [">", "@entity.health", 0]
- *
- * // Effect: set x to x + vx
- * ["set", "@entity.x", ["+", "@entity.x", "@entity.vx"]]
- *
- * @packageDocumentation
- */
-
-/**
- * S-Expression type - recursive structure representing expressions.
- *
- * An S-expression is either:
- * - A literal value (string, number, boolean, null)
- * - An object literal (for payload data, props, etc.)
- * - A binding reference (string starting with @)
- * - A call expression (array with operator as first element)
- */
-type SExprAtom = string | number | boolean | null | Record<string, unknown>;
-type SExpr = SExprAtom | SExpr[];
-/**
- * Expression type - S-expressions only.
- * Used for guards, computed values, and effect expressions.
- *
- * NOTE: Legacy string format is no longer supported.
- * All expressions must be S-expression arrays.
- */
-type Expression = SExpr;
-/**
- * Recursive schema for S-expressions.
- * Validates that arrays have at least one element and first element is a string (operator).
- */
-declare const SExprSchema: z.ZodType<SExpr>;
-/**
- * Schema for Expression type - S-expressions only.
- * S-expressions are arrays with operator as first element.
- *
- * NOTE: Legacy string format is no longer supported.
- */
-declare const ExpressionSchema: z.ZodType<Expression>;
-/**
- * Type guard for S-expression detection.
- * 100% reliable - structural check, no regex or keyword matching.
- *
- * @param value - Value to check
- * @returns true if value is an S-expression (array with string operator)
- */
-declare function isSExpr(value: unknown): value is SExpr[];
-/**
- * Type guard for S-expression atoms (non-array values).
- * Includes objects (for payload data, props, etc.)
- */
-declare function isSExprAtom(value: unknown): value is SExprAtom;
-/**
- * Check if a value is a binding reference.
- * Bindings start with @ (e.g., @entity.health, @payload.amount, @now)
- */
-declare function isBinding(value: unknown): value is string;
-/**
- * Check if a value is a valid S-expression call (array with operator).
- * Use this to distinguish between S-expression calls and atom values.
- */
-declare function isSExprCall(value: unknown): value is SExpr[];
-/**
- * Parsed binding reference
- */
-interface ParsedBinding {
-    /** Type of binding: core (@entity, @payload, @state, @now) or entity (@EntityName) */
-    type: 'core' | 'entity';
-    /** The root binding name (entity, payload, state, now, or EntityName) */
-    root: string;
-    /** Path segments after the root (e.g., ['health'] for @entity.health) */
-    path: string[];
-    /** Full original binding string */
-    original: string;
-}
-/**
- * Core bindings that are always available.
- * Phase 4.5 adds: config, computed, trait (for behavior support)
- */
-declare const CORE_BINDINGS: readonly ["entity", "payload", "state", "now", "config", "computed", "trait"];
-type CoreBinding = (typeof CORE_BINDINGS)[number];
-/**
- * Parse a binding reference into its components.
- * Does NOT use regex - uses structured string operations.
- *
- * @param binding - Binding string starting with @
- * @returns Parsed binding object or null if invalid
- */
-declare function parseBinding(binding: string): ParsedBinding | null;
-/**
- * Validate a binding reference format.
- *
- * @param binding - Binding string to validate
- * @returns true if valid binding format
- */
-declare function isValidBinding(binding: string): boolean;
-/**
- * Get the operator from an S-expression call.
- *
- * @param expr - S-expression array
- * @returns The operator string or null if not a valid call
- */
-declare function getOperator(expr: SExpr): string | null;
-/**
- * Get the arguments from an S-expression call.
- *
- * @param expr - S-expression array
- * @returns Array of arguments (empty if not a valid call)
- */
-declare function getArgs(expr: SExpr): SExpr[];
-/**
- * Create an S-expression call.
- *
- * @param operator - The operator string
- * @param args - Arguments to the operator
- * @returns S-expression array
- */
-declare function sexpr(operator: string, ...args: SExpr[]): SExpr[];
-/**
- * Walk an S-expression tree and apply a visitor function to each node.
- *
- * @param expr - S-expression to walk
- * @param visitor - Function to call on each node
- */
-declare function walkSExpr(expr: SExpr, visitor: (node: SExpr, parent: SExpr[] | null, index: number) => void, parent?: SExpr[] | null, index?: number): void;
-/**
- * Collect all bindings referenced in an S-expression.
- *
- * @param expr - S-expression to analyze
- * @returns Array of binding strings found
- */
-declare function collectBindings(expr: SExpr): string[];
+import { SExpr } from '@almadar/core';
 
 /**
  * Evaluation Context
@@ -495,4 +354,4 @@ declare function evalIncrement(args: SExpr[], evaluate: Evaluator, ctx: Evaluati
  */
 declare function evalDecrement(args: SExpr[], evaluate: Evaluator, ctx: EvaluationContext): void;
 
-export { evalOr as $, evalFirst as A, evalFloor as B, CORE_BINDINGS as C, evalFn as D, type EvaluationContext as E, evalGreaterThan as F, evalGreaterThanOrEqual as G, evalIf as H, evalIncludes as I, evalIncrement as J, evalLast as K, evalLessThan as L, evalLessThanOrEqual as M, evalLet as N, evalMap as O, type ParsedBinding as P, evalMatches as Q, evalMax as R, type SExpr as S, evalMin as T, evalModulo as U, evalMultiply as V, evalNavigate as W, evalNot as X, evalNotEqual as Y, evalNotify as Z, evalNth as _, type CoreBinding as a, evalPersist as a0, evalRenderUI as a1, evalRound as a2, evalSet as a3, evalSetDynamic as a4, evalSpawn as a5, evalSubtract as a6, evalSum as a7, evalWhen as a8, getArgs as a9, getOperator as aa, isBinding as ab, isSExpr as ac, isSExprAtom as ad, isSExprCall as ae, isValidBinding as af, parseBinding as ag, resolveBinding as ah, sexpr as ai, walkSExpr as aj, type Expression as b, ExpressionSchema as c, type SExprAtom as d, SExprSchema as e, collectBindings as f, createChildContext as g, createEffectContext as h, createMinimalContext as i, evalAbs as j, evalAdd as k, evalAnd as l, evalCallService as m, evalCeil as n, evalClamp as o, evalConcat as p, evalCount as q, evalDecrement as r, evalDespawn as s, evalDivide as t, evalDo as u, evalEmit as v, evalEmpty as w, evalEqual as x, evalFilter as y, evalFind as z };
+export { evalWhen as $, evalIncludes as A, evalIncrement as B, evalLast as C, evalLessThan as D, type EvaluationContext as E, evalLessThanOrEqual as F, evalLet as G, evalMap as H, evalMatches as I, evalMax as J, evalMin as K, evalModulo as L, evalMultiply as M, evalNavigate as N, evalNot as O, evalNotEqual as P, evalNotify as Q, evalNth as R, evalOr as S, evalPersist as T, evalRenderUI as U, evalRound as V, evalSet as W, evalSetDynamic as X, evalSpawn as Y, evalSubtract as Z, evalSum as _, createEffectContext as a, resolveBinding as a0, createMinimalContext as b, createChildContext as c, evalAdd as d, evalAbs as e, evalAnd as f, evalCallService as g, evalCeil as h, evalClamp as i, evalConcat as j, evalCount as k, evalDecrement as l, evalDespawn as m, evalDivide as n, evalDo as o, evalEmit as p, evalEmpty as q, evalEqual as r, evalFilter as s, evalFind as t, evalFirst as u, evalFloor as v, evalFn as w, evalGreaterThan as x, evalGreaterThanOrEqual as y, evalIf as z };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { S as SExpr, E as EvaluationContext } from './index-BBb9Y3Sp.js';
-export { C as CORE_BINDINGS, a as CoreBinding, b as Expression, c as ExpressionSchema, P as ParsedBinding, d as SExprAtom, e as SExprSchema, f as collectBindings, g as createChildContext, h as createEffectContext, i as createMinimalContext, j as evalAbs, k as evalAdd, l as evalAnd, m as evalCallService, n as evalCeil, o as evalClamp, p as evalConcat, q as evalCount, r as evalDecrement, s as evalDespawn, t as evalDivide, u as evalDo, v as evalEmit, w as evalEmpty, x as evalEqual, y as evalFilter, z as evalFind, A as evalFirst, B as evalFloor, D as evalFn, F as evalGreaterThan, G as evalGreaterThanOrEqual, H as evalIf, I as evalIncludes, J as evalIncrement, K as evalLast, L as evalLessThan, M as evalLessThanOrEqual, N as evalLet, O as evalMap, Q as evalMatches, R as evalMax, T as evalMin, U as evalModulo, V as evalMultiply, W as evalNavigate, X as evalNot, Y as evalNotEqual, Z as evalNotify, _ as evalNth, $ as evalOr, a0 as evalPersist, a1 as evalRenderUI, a2 as evalRound, a3 as evalSet, a4 as evalSetDynamic, a5 as evalSpawn, a6 as evalSubtract, a7 as evalSum, a8 as evalWhen, a9 as getArgs, aa as getOperator, ab as isBinding, ac as isSExpr, ad as isSExprAtom, ae as isSExprCall, af as isValidBinding, ag as parseBinding, ah as resolveBinding, ai as sexpr, aj as walkSExpr } from './index-BBb9Y3Sp.js';
-import 'zod';
+import { SExpr } from '@almadar/core';
+export { CORE_BINDINGS, CoreBinding, Expression, ExpressionSchema, ParsedBinding, SExpr, SExprAtom, SExprSchema, collectBindings, getArgs, getOperator, isBinding, isSExpr, isSExprAtom, isSExprCall, isValidBinding, parseBinding, sexpr, walkSExpr } from '@almadar/core';
+import { E as EvaluationContext } from './index-DsM_--K3.js';
+export { c as createChildContext, a as createEffectContext, b as createMinimalContext, e as evalAbs, d as evalAdd, f as evalAnd, g as evalCallService, h as evalCeil, i as evalClamp, j as evalConcat, k as evalCount, l as evalDecrement, m as evalDespawn, n as evalDivide, o as evalDo, p as evalEmit, q as evalEmpty, r as evalEqual, s as evalFilter, t as evalFind, u as evalFirst, v as evalFloor, w as evalFn, x as evalGreaterThan, y as evalGreaterThanOrEqual, z as evalIf, A as evalIncludes, B as evalIncrement, C as evalLast, D as evalLessThan, F as evalLessThanOrEqual, G as evalLet, H as evalMap, I as evalMatches, J as evalMax, K as evalMin, L as evalModulo, M as evalMultiply, N as evalNavigate, O as evalNot, P as evalNotEqual, Q as evalNotify, R as evalNth, S as evalOr, T as evalPersist, U as evalRenderUI, V as evalRound, W as evalSet, X as evalSetDynamic, Y as evalSpawn, Z as evalSubtract, _ as evalSum, $ as evalWhen, a0 as resolveBinding } from './index-DsM_--K3.js';
 
 /**
  * S-Expression Evaluator
@@ -70,4 +71,4 @@ declare function evaluateGuard(expr: SExpr, ctx: EvaluationContext): boolean;
 declare function executeEffect(expr: SExpr, ctx: EvaluationContext): void;
 declare function executeEffects(effects: SExpr[], ctx: EvaluationContext): void;
 
-export { EvaluationContext, SExpr, SExpressionEvaluator, evaluate, evaluateGuard, evaluator, executeEffect, executeEffects };
+export { EvaluationContext, SExpressionEvaluator, evaluate, evaluateGuard, evaluator, executeEffect, executeEffects };