@variojs/core 0.0.1

package/dist/runtime/loop-context-pool.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 循环上下文对象池
+ *
+ * 功能：
+ * - 复用循环上下文对象，减少内存分配
+ * - 提升循环性能
+ * - 自动清理和重置
+ */
+import type { RuntimeContext } from '../types.js';
+/**
+ * 循环上下文对象池
+ */
+declare class LoopContextPool {
+    private pool;
+    private maxSize;
+    constructor(maxSize?: number);
+    /**
+     * 获取一个循环上下文对象
+     */
+    acquire(): Partial<RuntimeContext>;
+    /**
+     * 释放循环上下文对象回池中
+     */
+    release(ctx: Partial<RuntimeContext>): void;
+    /**
+     * 清空对象池
+     */
+    clear(): void;
+    /**
+     * 获取池大小
+     */
+    get size(): number;
+}
+/**
+ * 获取全局循环上下文对象池
+ */
+export declare function getLoopContextPool(): LoopContextPool;
+/**
+ * 创建循环上下文（使用对象池）
+ *
+ * @param parentCtx 父上下文
+ * @param item 循环项
+ * @param index 循环索引
+ * @returns 循环上下文
+ */
+export declare function createLoopContext(parentCtx: RuntimeContext, item: unknown, index: number): RuntimeContext;
+/**
+ * 释放循环上下文（回收到对象池）
+ *
+ * @param loopCtx 循环上下文
+ */
+export declare function releaseLoopContext(loopCtx: Partial<RuntimeContext>): void;
+/**
+ * 清空对象池（用于测试或重置）
+ */
+export declare function clearLoopContextPool(): void;
+export {};
+//# sourceMappingURL=loop-context-pool.d.ts.map

package/dist/runtime/loop-context-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-context-pool.d.ts","sourceRoot":"","sources":["../../src/runtime/loop-context-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,OAAO,CAAQ;gBAEX,OAAO,GAAE,MAAW;IAIhC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAOlC;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAsB3C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAOD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,GACZ,cAAc,CAehB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAGzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAI3C"}

package/dist/runtime/loop-context-pool.js

@@ -0,0 +1,114 @@
+/**
+ * 循环上下文对象池
+ *
+ * 功能：
+ * - 复用循环上下文对象，减少内存分配
+ * - 提升循环性能
+ * - 自动清理和重置
+ */
+/**
+ * 循环上下文对象池
+ */
+class LoopContextPool {
+    pool = [];
+    maxSize;
+    constructor(maxSize = 10) {
+        this.maxSize = maxSize;
+    }
+    /**
+     * 获取一个循环上下文对象
+     */
+    acquire() {
+        if (this.pool.length > 0) {
+            return this.pool.pop();
+        }
+        return {};
+    }
+    /**
+     * 释放循环上下文对象回池中
+     */
+    release(ctx) {
+        // 清理循环相关属性
+        if ('$item' in ctx)
+            delete ctx.$item;
+        if ('$index' in ctx)
+            delete ctx.$index;
+        // 清理动态添加的循环变量（保留系统 API）
+        const keysToDelete = [];
+        for (const key in ctx) {
+            if (!key.startsWith('$') && !key.startsWith('_')) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            delete ctx[key];
+        }
+        // 如果池未满，回收对象
+        if (this.pool.length < this.maxSize) {
+            this.pool.push(ctx);
+        }
+    }
+    /**
+     * 清空对象池
+     */
+    clear() {
+        this.pool.length = 0;
+    }
+    /**
+     * 获取池大小
+     */
+    get size() {
+        return this.pool.length;
+    }
+}
+/**
+ * 全局循环上下文对象池实例
+ */
+let globalPool = null;
+/**
+ * 获取全局循环上下文对象池
+ */
+export function getLoopContextPool() {
+    if (!globalPool) {
+        globalPool = new LoopContextPool();
+    }
+    return globalPool;
+}
+/**
+ * 创建循环上下文（使用对象池）
+ *
+ * @param parentCtx 父上下文
+ * @param item 循环项
+ * @param index 循环索引
+ * @returns 循环上下文
+ */
+export function createLoopContext(parentCtx, item, index) {
+    const pool = getLoopContextPool();
+    const baseCtx = pool.acquire();
+    // 创建循环上下文（浅拷贝父上下文 + 循环属性）
+    const loopCtx = Object.create(parentCtx);
+    // 复制基础对象池中的属性（如果有）
+    Object.assign(loopCtx, baseCtx);
+    // 设置循环相关属性
+    loopCtx.$item = item;
+    loopCtx.$index = index;
+    return loopCtx;
+}
+/**
+ * 释放循环上下文（回收到对象池）
+ *
+ * @param loopCtx 循环上下文
+ */
+export function releaseLoopContext(loopCtx) {
+    const pool = getLoopContextPool();
+    pool.release(loopCtx);
+}
+/**
+ * 清空对象池（用于测试或重置）
+ */
+export function clearLoopContextPool() {
+    if (globalPool) {
+        globalPool.clear();
+    }
+}
+//# sourceMappingURL=loop-context-pool.js.map

package/dist/runtime/loop-context-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-context-pool.js","sourceRoot":"","sources":["../../src/runtime/loop-context-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,eAAe;IACX,IAAI,GAAmC,EAAE,CAAA;IACzC,OAAO,CAAQ;IAEvB,YAAY,UAAkB,EAAE;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAG,CAAA;QACzB,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAA4B;QAClC,WAAW;QACX,IAAI,OAAO,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,KAAK,CAAA;QACpC,IAAI,QAAQ,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,MAAM,CAAA;QAEtC,wBAAwB;QACxB,MAAM,YAAY,GAAa,EAAE,CAAA;QACjC,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACxB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;YAC/B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;QAED,aAAa;QACb,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAA;IACtB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAA;IACzB,CAAC;CACF;AAED;;GAEG;AACH,IAAI,UAAU,GAA2B,IAAI,CAAA;AAE7C;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACpC,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAyB,EACzB,IAAa,EACb,KAAa;IAEb,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAA;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;IAE9B,0BAA0B;IAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAmB,CAAA;IAE1D,mBAAmB;IACnB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAE/B,WAAW;IACX,OAAO,CAAC,KAAK,GAAG,IAAI,CAAA;IACpB,OAAO,CAAC,MAAM,GAAG,KAAK,CAAA;IAEtB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,MAAM,IAAI,GAAG,kBAAkB,EAAE,CAAA;IACjC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,UAAU,EAAE,CAAC;QACf,UAAU,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/runtime/path.d.ts

@@ -0,0 +1,114 @@
+/**
+ * 路径解析工具模块
+ *
+ * 统一的路径解析逻辑，供 vario-core 和框架集成层使用
+ *
+ * 设计原则：
+ * - 单一职责：只处理路径解析，不涉及响应式
+ * - 可组合：提供原子操作，框架集成层可自由组合
+ * - 类型安全：尽可能提供类型推导
+ */
+/**
+ * 路径段类型
+ */
+export type PathSegment = string | number;
+/**
+ * 解析路径字符串为段数组
+ *
+ * 支持两种语法：
+ * - 点语法：`user.name` → ['user', 'name']
+ * - 括号语法：`users[0].name` → ['users', 0, 'name']
+ * - 混合语法：`data.users[0].profile.tags[1]` → ['data', 'users', 0, 'profile', 'tags', 1]
+ * - 空括号：`users[].name` → ['users', -1, 'name']（-1 表示动态索引，由循环上下文填充）
+ *
+ * @param path 路径字符串
+ * @returns 路径段数组
+ *
+ * @example
+ * parsePath('user.name') // ['user', 'name']
+ * parsePath('items.0.text') // ['items', 0, 'text']
+ * parsePath('users[0].name') // ['users', 0, 'name']
+ * parsePath('users[].name') // ['users', -1, 'name']
+ */
+export declare function parsePath(path: string): PathSegment[];
+/**
+ * 解析路径（带缓存）
+ *
+ * @param path 点分隔的路径字符串
+ * @returns 路径段数组
+ */
+export declare function parsePathCached(path: string): PathSegment[];
+/**
+ * 清理路径缓存
+ */
+export declare function clearPathCache(): void;
+/**
+ * 将路径段数组转换为路径字符串
+ *
+ * @param segments 路径段数组
+ * @returns 点分隔的路径字符串
+ */
+export declare function stringifyPath(segments: PathSegment[]): string;
+/**
+ * 获取嵌套路径的值
+ *
+ * @param obj 目标对象
+ * @param path 路径字符串或路径段数组
+ * @returns 路径对应的值，不存在返回 undefined
+ */
+export declare function getPathValue(obj: Record<string, unknown>, path: string | PathSegment[]): unknown;
+/**
+ * 设置嵌套路径的值
+ *
+ * @param obj 目标对象
+ * @param path 路径字符串或路径段数组
+ * @param value 要设置的值
+ * @param options 配置选项
+ * @returns 是否设置成功
+ */
+export declare function setPathValue(obj: Record<string, unknown>, path: string | PathSegment[], value: unknown, options?: {
+    /**
+     * 自动创建中间路径
+     * @default true
+     */
+    createIntermediate?: boolean;
+    /**
+     * 创建对象的工厂函数
+     * 用于框架集成层创建响应式对象
+     */
+    createObject?: () => Record<string, unknown>;
+    /**
+     * 创建数组的工厂函数
+     * 用于框架集成层创建响应式数组
+     */
+    createArray?: () => unknown[];
+}): boolean;
+/**
+ * 检查路径是否匹配（支持通配符）
+ *
+ * @param pattern 模式路径（支持 * 通配符）
+ * @param path 目标路径
+ * @returns 是否匹配
+ *
+ * @example
+ * matchPath('items.*', 'items.0') // true
+ * matchPath('items.*.name', 'items.0.name') // true
+ * matchPath('user.name', 'user.name') // true
+ * matchPath('user.name', 'user.age') // false
+ */
+export declare function matchPath(pattern: string, path: string): boolean;
+/**
+ * 提取路径的父路径
+ *
+ * @param path 路径字符串
+ * @returns 父路径，顶层路径返回空字符串
+ */
+export declare function getParentPath(path: string): string;
+/**
+ * 获取路径的最后一段
+ *
+ * @param path 路径字符串
+ * @returns 最后一段
+ */
+export declare function getLastSegment(path: string): PathSegment | undefined;
+//# sourceMappingURL=path.d.ts.map

package/dist/runtime/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/runtime/path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAUzC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CA+DrD;AAaD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAa3D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,GAC3B,OAAO,CA8BT;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,EAC5B,KAAK,EAAE,OAAO,EACd,OAAO,GAAE;IACP;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAE5B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE5C;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,EAAE,CAAA;CACzB,GACL,OAAO,CA8ET;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuBhE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAGpE"}

package/dist/runtime/path.js

@@ -0,0 +1,302 @@
+/**
+ * 路径解析工具模块
+ *
+ * 统一的路径解析逻辑，供 vario-core 和框架集成层使用
+ *
+ * 设计原则：
+ * - 单一职责：只处理路径解析，不涉及响应式
+ * - 可组合：提供原子操作，框架集成层可自由组合
+ * - 类型安全：尽可能提供类型推导
+ */
+const pathCache = {
+    parsed: new Map()
+};
+/**
+ * 解析路径字符串为段数组
+ *
+ * 支持两种语法：
+ * - 点语法：`user.name` → ['user', 'name']
+ * - 括号语法：`users[0].name` → ['users', 0, 'name']
+ * - 混合语法：`data.users[0].profile.tags[1]` → ['data', 'users', 0, 'profile', 'tags', 1]
+ * - 空括号：`users[].name` → ['users', -1, 'name']（-1 表示动态索引，由循环上下文填充）
+ *
+ * @param path 路径字符串
+ * @returns 路径段数组
+ *
+ * @example
+ * parsePath('user.name') // ['user', 'name']
+ * parsePath('items.0.text') // ['items', 0, 'text']
+ * parsePath('users[0].name') // ['users', 0, 'name']
+ * parsePath('users[].name') // ['users', -1, 'name']
+ */
+export function parsePath(path) {
+    if (!path || path.length === 0) {
+        return [];
+    }
+    const segments = [];
+    let current = '';
+    let i = 0;
+    while (i < path.length) {
+        const char = path[i];
+        if (char === '.') {
+            // 点分隔符：保存当前段
+            if (current) {
+                segments.push(parseSegment(current));
+                current = '';
+            }
+            i++;
+        }
+        else if (char === '[') {
+            // 括号开始：保存当前段（如果有），然后解析括号内容
+            if (current) {
+                segments.push(parseSegment(current));
+                current = '';
+            }
+            // 找到匹配的 ]
+            const closeIndex = path.indexOf(']', i);
+            if (closeIndex === -1) {
+                // 没有匹配的 ]，当作普通字符处理
+                current += char;
+                i++;
+            }
+            else {
+                const indexStr = path.slice(i + 1, closeIndex);
+                if (indexStr === '') {
+                    // 空括号 [] 表示动态索引
+                    segments.push(-1);
+                }
+                else if (/^\d+$/.test(indexStr)) {
+                    // 数字索引
+                    segments.push(parseInt(indexStr, 10));
+                }
+                else {
+                    // 非数字，当作字符串键
+                    segments.push(indexStr);
+                }
+                i = closeIndex + 1;
+                // 跳过紧跟的点
+                if (path[i] === '.') {
+                    i++;
+                }
+            }
+        }
+        else {
+            current += char;
+            i++;
+        }
+    }
+    // 处理最后一段
+    if (current) {
+        segments.push(parseSegment(current));
+    }
+    return segments;
+}
+/**
+ * 解析单个路径段
+ */
+function parseSegment(segment) {
+    // 纯数字视为数组索引（保持向后兼容 items.0.text 语法）
+    if (/^\d+$/.test(segment)) {
+        return parseInt(segment, 10);
+    }
+    return segment;
+}
+/**
+ * 解析路径（带缓存）
+ *
+ * @param path 点分隔的路径字符串
+ * @returns 路径段数组
+ */
+export function parsePathCached(path) {
+    if (!path || path.length === 0) {
+        return [];
+    }
+    const cached = pathCache.parsed.get(path);
+    if (cached) {
+        return cached;
+    }
+    const segments = parsePath(path);
+    pathCache.parsed.set(path, segments);
+    return segments;
+}
+/**
+ * 清理路径缓存
+ */
+export function clearPathCache() {
+    pathCache.parsed.clear();
+}
+/**
+ * 将路径段数组转换为路径字符串
+ *
+ * @param segments 路径段数组
+ * @returns 点分隔的路径字符串
+ */
+export function stringifyPath(segments) {
+    return segments.map(String).join('.');
+}
+/**
+ * 获取嵌套路径的值
+ *
+ * @param obj 目标对象
+ * @param path 路径字符串或路径段数组
+ * @returns 路径对应的值，不存在返回 undefined
+ */
+export function getPathValue(obj, path) {
+    const segments = typeof path === 'string' ? parsePathCached(path) : path;
+    if (segments.length === 0) {
+        return obj;
+    }
+    let value = obj;
+    for (const segment of segments) {
+        if (value == null) {
+            return undefined;
+        }
+        if (typeof segment === 'number') {
+            // 数组索引
+            if (!Array.isArray(value)) {
+                return undefined;
+            }
+            value = value[segment];
+        }
+        else {
+            // 对象属性
+            if (typeof value !== 'object') {
+                return undefined;
+            }
+            value = value[segment];
+        }
+    }
+    return value;
+}
+/**
+ * 设置嵌套路径的值
+ *
+ * @param obj 目标对象
+ * @param path 路径字符串或路径段数组
+ * @param value 要设置的值
+ * @param options 配置选项
+ * @returns 是否设置成功
+ */
+export function setPathValue(obj, path, value, options = {}) {
+    const { createIntermediate = true, createObject = () => ({}), createArray = () => [] } = options;
+    const segments = typeof path === 'string' ? parsePathCached(path) : path;
+    if (segments.length === 0) {
+        return false;
+    }
+    const lastSegment = segments[segments.length - 1];
+    const parentSegments = segments.slice(0, -1);
+    // 找到或创建父对象
+    let target = obj;
+    for (let i = 0; i < parentSegments.length; i++) {
+        const segment = parentSegments[i];
+        const nextSegment = parentSegments[i + 1] ?? lastSegment;
+        const nextIsArrayIndex = typeof nextSegment === 'number';
+        if (typeof segment === 'number') {
+            // 当前段是数组索引
+            if (!Array.isArray(target)) {
+                if (!createIntermediate)
+                    return false;
+                // 无法将非数组转换为数组
+                return false;
+            }
+            // 确保数组足够长
+            while (target.length <= segment) {
+                target.push(undefined);
+            }
+            // 确保目标位置是对象或数组
+            if (target[segment] == null || typeof target[segment] !== 'object') {
+                if (!createIntermediate)
+                    return false;
+                target[segment] = nextIsArrayIndex ? createArray() : createObject();
+            }
+            target = target[segment];
+        }
+        else {
+            // 当前段是对象属性
+            if (typeof target !== 'object' || target === null) {
+                return false;
+            }
+            const targetObj = target;
+            if (targetObj[segment] == null || typeof targetObj[segment] !== 'object') {
+                if (!createIntermediate)
+                    return false;
+                targetObj[segment] = nextIsArrayIndex ? createArray() : createObject();
+            }
+            target = targetObj[segment];
+        }
+    }
+    // 设置最终值
+    if (typeof lastSegment === 'number') {
+        if (!Array.isArray(target)) {
+            return false;
+        }
+        while (target.length <= lastSegment) {
+            target.push(undefined);
+        }
+        target[lastSegment] = value;
+    }
+    else {
+        if (typeof target !== 'object' || target === null) {
+            return false;
+        }
+        target[lastSegment] = value;
+    }
+    return true;
+}
+/**
+ * 检查路径是否匹配（支持通配符）
+ *
+ * @param pattern 模式路径（支持 * 通配符）
+ * @param path 目标路径
+ * @returns 是否匹配
+ *
+ * @example
+ * matchPath('items.*', 'items.0') // true
+ * matchPath('items.*.name', 'items.0.name') // true
+ * matchPath('user.name', 'user.name') // true
+ * matchPath('user.name', 'user.age') // false
+ */
+export function matchPath(pattern, path) {
+    // 精确匹配
+    if (pattern === path) {
+        return true;
+    }
+    // 检查是否为父路径
+    if (path.startsWith(pattern + '.')) {
+        return true;
+    }
+    // 通配符匹配
+    if (pattern.includes('*')) {
+        const parentPath = pattern.split('.*')[0];
+        return path.startsWith(parentPath + '.') || path === parentPath;
+    }
+    // 检查是否路径影响模式
+    if (pattern.startsWith(path + '.')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * 提取路径的父路径
+ *
+ * @param path 路径字符串
+ * @returns 父路径，顶层路径返回空字符串
+ */
+export function getParentPath(path) {
+    const segments = parsePathCached(path);
+    if (segments.length <= 1) {
+        return '';
+    }
+    return stringifyPath(segments.slice(0, -1));
+}
+/**
+ * 获取路径的最后一段
+ *
+ * @param path 路径字符串
+ * @returns 最后一段
+ */
+export function getLastSegment(path) {
+    const segments = parsePathCached(path);
+    return segments[segments.length - 1];
+}
+//# sourceMappingURL=path.js.map

package/dist/runtime/path.js.map

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

package/dist/runtime/proxy.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Proxy 沙箱实现
+ *
+ * 功能：
+ * - 防止覆盖系统 API（$ 和 _ 前缀保护）
+ * - 拦截属性设置操作
+ */
+import type { RuntimeContext } from '../types.js';
+/**
+ * 创建受保护的 Proxy 上下文
+ * 禁止设置以 $ 或 _ 开头的属性
+ *
+ * @template T 上下文类型，必须是 RuntimeContext 的子类型
+ * @param ctx 运行时上下文对象
+ * @returns 受保护的 Proxy 包装的上下文
+ */
+export declare function createProxy<T extends RuntimeContext>(ctx: T): T;
+//# sourceMappingURL=proxy.d.ts.map

package/dist/runtime/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../src/runtime/proxy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,cAAc,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAgD/D"}