@variojs/core 0.0.1

package/README.md

@@ -0,0 +1,270 @@
+# @variojs/core
+
+Vario Core Runtime - 指令虚拟机、表达式系统、运行时上下文
+
+## 简介
+
+`@variojs/core` 是 Vario 的核心运行时模块，提供了框架无关的基础能力：
+
+- **RuntimeContext**: 扁平化状态管理 + `$` 前缀系统 API
+- **Expression System**: 安全表达式解析、编译和求值
+- **Action VM**: 指令虚拟机，执行各种操作指令
+- **安全沙箱**: 多层防护机制，防止恶意代码执行
+- **性能优化**: 表达式缓存、对象池、路径记忆化
+
+## 安装
+
+```bash
+npm install @variojs/core
+# 或
+pnpm add @variojs/core
+```
+
+## 核心概念
+
+### RuntimeContext 运行时上下文
+
+运行时上下文是 Vario 的核心，提供了扁平化的状态管理和系统 API：
+
+```typescript
+import { createRuntimeContext } from '@variojs/core'
+
+const ctx = createRuntimeContext({
+  state: {
+    count: 0,
+    user: { name: 'John', age: 30 }
+  },
+  methods: {
+    increment: (ctx) => {
+      ctx._set('count', ctx._get('count') + 1)
+    }
+  }
+})
+
+// 访问状态（扁平化，无 models. 前缀）
+ctx.count  // 0
+ctx.user.name  // 'John'
+
+// 使用系统 API
+ctx._get('count')  // 0
+ctx._set('count', 10)  // 设置值
+ctx.$emit('countChanged', 10)  // 发射事件
+```
+
+### Expression System 表达式系统
+
+安全、强大的表达式求值引擎，支持复杂的条件判断、数据访问和计算：
+
+```typescript
+import { createExpressionSandbox, compileExpression } from '@variojs/core'
+
+const sandbox = createExpressionSandbox(ctx)
+
+// 编译表达式
+const expr = compileExpression('count > 10 && user.age >= 18')
+
+// 求值
+const result = expr.evaluate(sandbox)  // true/false
+```
+
+**支持的语法**：
+- 变量访问：`count`, `user.name`
+- 数组访问：`items[0]`, `todos[index]`
+- 可选链：`user?.profile?.email`
+- 二元运算：`count + 1`, `price * quantity`
+- 比较运算：`count > 10`, `role === "admin"`
+- 逻辑运算：`showContent && isActive`
+- 三元表达式：`count > 10 ? "high" : "low"`
+- 函数调用（白名单）：`Array.isArray(items)`, `Math.max(a, b)`
+
+### Action VM 指令虚拟机
+
+执行各种操作指令，如 `set`、`call`、`if`、`loop` 等：
+
+```typescript
+import { createVMExecutor } from '@variojs/core'
+
+const executor = createVMExecutor(ctx)
+
+// 执行 set 指令
+await executor.execute({
+  type: 'set',
+  path: 'count',
+  value: 10
+})
+
+// 执行 call 指令
+await executor.execute({
+  type: 'call',
+  method: 'increment'
+})
+
+// 执行 if 指令
+await executor.execute({
+  type: 'if',
+  cond: 'count > 10',
+  then: {
+    type: 'set',
+    path: 'status',
+    value: 'high'
+  }
+})
+```
+
+## API 参考
+
+### createRuntimeContext
+
+创建运行时上下文。
+
+```typescript
+function createRuntimeContext<TState extends Record<string, unknown>>(
+  options: CreateContextOptions<TState>
+): RuntimeContext<TState>
+```
+
+**选项**：
+
+```typescript
+interface CreateContextOptions<TState> {
+  /** 初始状态 */
+  state?: TState
+  /** 方法注册表 */
+  methods?: Record<string, MethodHandler>
+  /** 表达式选项 */
+  exprOptions?: ExpressionOptions
+  /** 事件发射器 */
+  onEmit?: (event: string, data?: unknown) => void
+  /** 状态变化回调 */
+  onStateChange?: (path: string, value: unknown) => void
+}
+```
+
+### Expression System
+
+```typescript
+// 创建表达式沙箱
+function createExpressionSandbox(ctx: RuntimeContext): ExpressionSandbox
+
+// 编译表达式
+function compileExpression(expr: string): CompiledExpression
+
+// 解析表达式
+function parseExpression(expr: string): ExpressionAST
+
+// 求值表达式
+function evaluateExpression(expr: string, ctx: RuntimeContext): unknown
+```
+
+### Action VM
+
+```typescript
+// 创建 VM 执行器
+function createVMExecutor(ctx: RuntimeContext): VMExecutor
+
+// 执行动作
+function executeAction(action: Action, ctx: RuntimeContext): Promise<void>
+```
+
+### Path Utilities
+
+路径解析和操作工具：
+
+```typescript
+// 解析路径
+function parsePath(path: string): PathSegment[]
+
+// 获取路径值
+function getPathValue(obj: Record<string, unknown>, path: string): unknown
+
+// 设置路径值
+function setPathValue(
+  obj: Record<string, unknown>,
+  path: string,
+  value: unknown,
+  options?: { createObject?: () => object, createArray?: () => unknown[] }
+): void
+
+// 路径匹配
+function matchPath(pattern: string, path: string): boolean
+```
+
+## 安全特性
+
+### 表达式白名单
+
+表达式系统使用白名单机制，只允许安全的操作：
+
+- ✅ 允许：属性访问、数组访问、数学运算、比较运算
+- ✅ 允许：白名单函数（`Array.isArray`, `Math.max` 等）
+- ❌ 禁止：`eval`, `Function`, `global`, `window` 等危险操作
+- ❌ 禁止：直接访问 Node.js API（`require`, `process` 等）
+
+### 沙箱机制
+
+表达式在隔离的沙箱中执行，无法访问外部作用域：
+
+```typescript
+const sandbox = createExpressionSandbox(ctx)
+
+// 只能访问 ctx 中定义的状态和方法
+// 无法访问全局变量、Node.js API 等
+```
+
+## 性能优化
+
+### 表达式缓存
+
+编译后的表达式会被缓存，避免重复编译：
+
+```typescript
+// 第一次编译
+const expr1 = compileExpression('count > 10')  // 编译
+
+// 第二次使用相同表达式
+const expr2 = compileExpression('count > 10')  // 从缓存获取
+```
+
+### 路径缓存
+
+路径解析结果会被缓存：
+
+```typescript
+parsePathCached('user.profile.name')  // 第一次解析
+parsePathCached('user.profile.name')  // 从缓存获取
+```
+
+### 对象池
+
+循环上下文使用对象池复用，减少内存分配：
+
+```typescript
+import { createLoopContext, releaseLoopContext } from '@variojs/core'
+
+// 创建循环上下文（从池中获取）
+const loopCtx = createLoopContext(ctx, { item, index })
+
+// 使用后释放（归还到池中）
+releaseLoopContext(loopCtx)
+```
+
+## 类型支持
+
+完整的 TypeScript 类型定义：
+
+```typescript
+import type {
+  RuntimeContext,
+  Action,
+  ExpressionOptions,
+  MethodHandler
+} from '@variojs/core'
+```
+
+## 示例
+
+查看主项目的 `play/src/examples/` 目录下的完整示例。
+
+## 许可证
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Vario 错误处理体系
+ *
+ * 统一的错误基类和错误码系统
+ */
+import type { Action } from './types.js';
+/**
+ * 错误上下文信息
+ */
+export interface ErrorContext {
+    /** Schema 路径（如 "events.click[0]"） */
+    schemaPath?: string;
+    /** 表达式字符串 */
+    expression?: string;
+    /** 动作对象 */
+    action?: Action;
+    /** 调用栈（简化版） */
+    stack?: string[];
+    /** 额外上下文信息 */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Vario 错误基类
+ *
+ * 所有 Vario 相关错误都应继承此类
+ */
+export declare class VarioError extends Error {
+    /** 错误码 */
+    readonly code: string;
+    /** 错误上下文 */
+    readonly context: ErrorContext;
+    constructor(message: string, code: string, context?: ErrorContext);
+    /**
+     * 获取友好的错误消息
+     */
+    getFriendlyMessage(): string;
+    /**
+     * 转换为 JSON（用于序列化）
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * 动作执行错误
+ */
+export declare class ActionError extends VarioError {
+    constructor(action: Action, message: string, code?: string, context?: Omit<ErrorContext, 'action'>);
+}
+/**
+ * 表达式求值错误
+ */
+export declare class ExpressionError extends VarioError {
+    constructor(expression: string, message: string, code?: string, context?: Omit<ErrorContext, 'expression'>);
+}
+/**
+ * 服务调用错误
+ */
+export declare class ServiceError extends VarioError {
+    readonly service: string;
+    readonly originalError?: Error;
+    constructor(service: string, message: string, originalError?: Error, context?: ErrorContext);
+}
+/**
+ * 批量执行错误
+ */
+export declare class BatchError extends VarioError {
+    readonly failedActions: Array<{
+        action: Action;
+        error: Error;
+    }>;
+    constructor(failedActions: Array<{
+        action: Action;
+        error: Error;
+    }>, message: string, context?: ErrorContext);
+}
+/**
+ * 错误码定义
+ */
+export declare const ErrorCodes: {
+    readonly ACTION_UNKNOWN_TYPE: "ACTION_UNKNOWN_TYPE";
+    readonly ACTION_EXECUTION_ERROR: "ACTION_EXECUTION_ERROR";
+    readonly ACTION_ABORTED: "ACTION_ABORTED";
+    readonly ACTION_TIMEOUT: "ACTION_TIMEOUT";
+    readonly ACTION_MAX_STEPS_EXCEEDED: "ACTION_MAX_STEPS_EXCEEDED";
+    readonly ACTION_MISSING_PARAM: "ACTION_MISSING_PARAM";
+    readonly ACTION_INVALID_PARAM: "ACTION_INVALID_PARAM";
+    readonly EXPRESSION_PARSE_ERROR: "EXPRESSION_PARSE_ERROR";
+    readonly EXPRESSION_VALIDATION_ERROR: "EXPRESSION_VALIDATION_ERROR";
+    readonly EXPRESSION_EVALUATION_ERROR: "EXPRESSION_EVALUATION_ERROR";
+    readonly EXPRESSION_TIMEOUT: "EXPRESSION_TIMEOUT";
+    readonly EXPRESSION_MAX_STEPS_EXCEEDED: "EXPRESSION_MAX_STEPS_EXCEEDED";
+    readonly EXPRESSION_UNSAFE_ACCESS: "EXPRESSION_UNSAFE_ACCESS";
+    readonly EXPRESSION_FUNCTION_NOT_WHITELISTED: "EXPRESSION_FUNCTION_NOT_WHITELISTED";
+    readonly SERVICE_NOT_FOUND: "SERVICE_NOT_FOUND";
+    readonly SERVICE_CALL_ERROR: "SERVICE_CALL_ERROR";
+    readonly BATCH_ERROR: "BATCH_ERROR";
+    readonly SCHEMA_VALIDATION_ERROR: "SCHEMA_VALIDATION_ERROR";
+    readonly SCHEMA_INVALID_ACTION: "SCHEMA_INVALID_ACTION";
+};
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAExC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,cAAc;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,UAAU;IACV,SAAgB,IAAI,EAAE,MAAM,CAAA;IAC5B,YAAY;IACZ,SAAgB,OAAO,EAAE,YAAY,CAAA;gBAGnC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAiB;IAa5B;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAkB5B;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;gBAEvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAuB,EAC7B,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAM;CAQ7C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;gBAE3C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAA2B,EACjC,OAAO,GAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAM;CAQjD;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,SAAgB,OAAO,EAAE,MAAM,CAAA;IAC/B,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAA;gBAGnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,KAAK,EACrB,OAAO,GAAE,YAAiB;CAO7B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,SAAgB,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAA;gBAGpE,aAAa,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,EACtD,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB;CAM7B;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;CA6Bb,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA"}

package/dist/errors.js

@@ -0,0 +1,132 @@
+/**
+ * Vario 错误处理体系
+ *
+ * 统一的错误基类和错误码系统
+ */
+/**
+ * Vario 错误基类
+ *
+ * 所有 Vario 相关错误都应继承此类
+ */
+export class VarioError extends Error {
+    /** 错误码 */
+    code;
+    /** 错误上下文 */
+    context;
+    constructor(message, code, context = {}) {
+        super(message);
+        this.name = 'VarioError';
+        this.code = code;
+        this.context = context;
+        // 确保 stack 属性存在
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, VarioError);
+        }
+    }
+    /**
+     * 获取友好的错误消息
+     */
+    getFriendlyMessage() {
+        const parts = [this.message];
+        if (this.context.schemaPath) {
+            parts.push(`\n  Schema 路径: ${this.context.schemaPath}`);
+        }
+        if (this.context.expression) {
+            parts.push(`\n  表达式: ${this.context.expression}`);
+        }
+        if (this.context.action) {
+            parts.push(`\n  动作类型: ${this.context.action.type}`);
+        }
+        return parts.join('');
+    }
+    /**
+     * 转换为 JSON（用于序列化）
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            stack: this.stack
+        };
+    }
+}
+/**
+ * 动作执行错误
+ */
+export class ActionError extends VarioError {
+    constructor(action, message, code = 'ACTION_ERROR', context = {}) {
+        super(message, code, {
+            ...context,
+            action
+        });
+        this.name = 'ActionError';
+    }
+}
+/**
+ * 表达式求值错误
+ */
+export class ExpressionError extends VarioError {
+    constructor(expression, message, code = 'EXPRESSION_ERROR', context = {}) {
+        super(message, code, {
+            ...context,
+            expression
+        });
+        this.name = 'ExpressionError';
+    }
+}
+/**
+ * 服务调用错误
+ */
+export class ServiceError extends VarioError {
+    service;
+    originalError;
+    constructor(service, message, originalError, context = {}) {
+        super(message, 'SERVICE_ERROR', context);
+        this.name = 'ServiceError';
+        this.service = service;
+        this.originalError = originalError;
+    }
+}
+/**
+ * 批量执行错误
+ */
+export class BatchError extends VarioError {
+    failedActions;
+    constructor(failedActions, message, context = {}) {
+        super(message, 'BATCH_ERROR', context);
+        this.name = 'BatchError';
+        this.failedActions = failedActions;
+    }
+}
+/**
+ * 错误码定义
+ */
+export const ErrorCodes = {
+    // 动作相关错误
+    ACTION_UNKNOWN_TYPE: 'ACTION_UNKNOWN_TYPE',
+    ACTION_EXECUTION_ERROR: 'ACTION_EXECUTION_ERROR',
+    ACTION_ABORTED: 'ACTION_ABORTED',
+    ACTION_TIMEOUT: 'ACTION_TIMEOUT',
+    ACTION_MAX_STEPS_EXCEEDED: 'ACTION_MAX_STEPS_EXCEEDED',
+    ACTION_MISSING_PARAM: 'ACTION_MISSING_PARAM',
+    ACTION_INVALID_PARAM: 'ACTION_INVALID_PARAM',
+    // 表达式相关错误
+    EXPRESSION_PARSE_ERROR: 'EXPRESSION_PARSE_ERROR',
+    EXPRESSION_VALIDATION_ERROR: 'EXPRESSION_VALIDATION_ERROR',
+    EXPRESSION_EVALUATION_ERROR: 'EXPRESSION_EVALUATION_ERROR',
+    EXPRESSION_TIMEOUT: 'EXPRESSION_TIMEOUT',
+    EXPRESSION_MAX_STEPS_EXCEEDED: 'EXPRESSION_MAX_STEPS_EXCEEDED',
+    EXPRESSION_UNSAFE_ACCESS: 'EXPRESSION_UNSAFE_ACCESS',
+    EXPRESSION_FUNCTION_NOT_WHITELISTED: 'EXPRESSION_FUNCTION_NOT_WHITELISTED',
+    // 服务相关错误
+    SERVICE_NOT_FOUND: 'SERVICE_NOT_FOUND',
+    SERVICE_CALL_ERROR: 'SERVICE_CALL_ERROR',
+    // 批量执行错误
+    BATCH_ERROR: 'BATCH_ERROR',
+    // Schema 相关错误
+    SCHEMA_VALIDATION_ERROR: 'SCHEMA_VALIDATION_ERROR',
+    SCHEMA_INVALID_ACTION: 'SCHEMA_INVALID_ACTION',
+};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/expression/cache.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 表达式缓存系统
+ *
+ * 功能：
+ * - 每个 RuntimeContext 独立缓存（WeakMap 关联）
+ * - LRU 淘汰策略
+ * - 通配符依赖匹配
+ * - 缓存失效机制
+ *
+ * 设计原则：
+ * - 惰性求值：只在需要时计算
+ * - 依赖追踪：精确的缓存失效
+ * - 内存友好：WeakMap + LRU 淘汰
+ */
+import type { RuntimeContext } from '../types.js';
+/**
+ * 获取缓存的表达式结果
+ *
+ * @param expr 表达式字符串
+ * @param ctx 运行时上下文
+ * @returns 缓存的结果，无缓存或已失效返回 null
+ */
+export declare function getCachedExpression(expr: string, ctx: RuntimeContext): unknown | null;
+/**
+ * 设置表达式缓存
+ *
+ * @param expr 表达式字符串
+ * @param result 求值结果
+ * @param dependencies 依赖的状态路径
+ * @param ctx 运行时上下文
+ */
+export declare function setCachedExpression(expr: string, result: unknown, dependencies: string[], ctx: RuntimeContext): void;
+/**
+ * 使缓存失效
+ *
+ * 当状态变化时调用，精确删除依赖该状态的缓存
+ *
+ * @param changedPath 变化的状态路径
+ * @param ctx 运行时上下文
+ */
+export declare function invalidateCache(changedPath: string, ctx: RuntimeContext): void;
+/**
+ * 清除指定上下文的所有缓存
+ */
+export declare function clearCache(ctx: RuntimeContext): void;
+/**
+ * 获取缓存统计信息（调试用）
+ */
+export declare function getCacheStats(ctx: RuntimeContext): {
+    size: number;
+    expressions: string[];
+};
+//# sourceMappingURL=cache.d.ts.map

package/dist/expression/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/expression/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,aAAa,CAAA;AA0ElE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc,GAClB,OAAO,GAAG,IAAI,CAgBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,MAAM,EAAE,EACtB,GAAG,EAAE,cAAc,GAClB,IAAI,CAcN;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,cAAc,GAClB,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAGpD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAMA"}