@variojs/core 0.1.0

package/dist/runtime/create-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context.d.ts","sourceRoot":"","sources":["../../src/runtime/create-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAA8B,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAMjH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAEhD;;OAEG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAA;IAE3E;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE5C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,OAAO,EAAE,CAAA;IAE7B;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAA;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEhE,YAAY,GAAE,OAAO,CAAC,MAAM,CAAyB,EACrD,OAAO,GAAE,oBAAyB,GACjC,cAAc,CAAC,MAAM,CAAC,CAqDxB"}

package/dist/runtime/create-context.js

@@ -0,0 +1,73 @@
+/**
+ * RuntimeContext 创建工厂
+ *
+ * 实现要点：
+ * - 扁平化状态存储
+ * - 系统 API 保护（$ 和 _ 前缀）
+ * - 命名冲突检测
+ * - Proxy 拦截防止覆盖系统 API
+ */
+import { createProxy } from './proxy.js';
+import { registerBuiltinMethods } from '../vm/handlers/index.js';
+import { getPathValue as getPath, setPathValue as setPath } from './path.js';
+import { invalidateCache } from '../expression/cache.js';
+/**
+ * 创建运行时上下文
+ *
+ * @param initialState 初始状态（扁平化）
+ * @param options 配置选项
+ *
+ * @template TState 状态类型，从 initialState 推导
+ */
+export function createRuntimeContext(initialState = {}, options = {}) {
+    // 1. 验证命名冲突
+    validateStateKeys(initialState);
+    const { onEmit, methods = {}, onStateChange, createObject = () => ({}), createArray = () => [], exprOptions } = options;
+    // 用于存储 proxied 引用，以便 _set 中的 onStateChange 能使用正确的引用
+    let proxiedRef = null;
+    // 2. 创建基础上下文对象
+    const ctx = {
+        ...initialState,
+        $emit: (event, data) => {
+            if (onEmit) {
+                onEmit(event, data);
+            }
+        },
+        $methods: methods,
+        $exprOptions: exprOptions,
+        _get: (path) => {
+            return getPath(ctx, path);
+        },
+        _set: (path, value, options) => {
+            setPath(ctx, path, value, {
+                createObject,
+                createArray
+            });
+            // 使缓存失效（使用 proxied 引用以确保缓存键一致）
+            invalidateCache(path, (proxiedRef || ctx));
+            // 触发状态变更钩子
+            if (onStateChange && !options?.skipCallback) {
+                onStateChange(path, value, (proxiedRef || ctx));
+            }
+        },
+    };
+    // 3. 自动注册内置指令到 $methods
+    registerBuiltinMethods(ctx);
+    // 4. 使用 Proxy 保护系统 API
+    const proxied = createProxy(ctx);
+    // 5. 保存 proxied 引用供 _set 使用
+    proxiedRef = proxied;
+    return proxied;
+}
+/**
+ * 验证状态键名，防止与系统 API 冲突
+ */
+function validateStateKeys(state) {
+    for (const key in state) {
+        if (key.startsWith('$') || key.startsWith('_')) {
+            throw new Error(`Property name "${key}" conflicts with system API. ` +
+                `Properties starting with "$" or "_" are reserved. Use a different name.`);
+        }
+    }
+}
+//# sourceMappingURL=create-context.js.map

package/dist/runtime/create-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context.js","sourceRoot":"","sources":["../../src/runtime/create-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAsCxD;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAGlC,eAAgC,EAAqB,EACrD,UAAgC,EAAE;IAElC,YAAY;IACZ,iBAAiB,CAAC,YAAY,CAAC,CAAA;IAE/B,MAAM,EACJ,MAAM,EACN,OAAO,GAAG,EAAE,EACZ,aAAa,EACb,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EACzB,WAAW,GAAG,GAAG,EAAE,CAAC,EAAE,EACtB,WAAW,EACZ,GAAG,OAAO,CAAA;IAEX,oDAAoD;IACpD,IAAI,UAAU,GAAkC,IAAI,CAAA;IAEpD,eAAe;IACf,MAAM,GAAG,GAAG;QACV,GAAG,YAAY;QACf,KAAK,EAAE,CAAC,KAAa,EAAE,IAAc,EAAE,EAAE;YACvC,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,OAA0B;QACpC,YAAY,EAAE,WAAW;QACzB,IAAI,EAAE,CAAuB,IAAW,EAA+B,EAAE;YACvE,OAAO,OAAO,CAAC,GAA8B,EAAE,IAAI,CAAgC,CAAA;QACrF,CAAC;QACD,IAAI,EAAE,CAAuB,IAAW,EAAE,KAAkC,EAAE,OAAoC,EAAQ,EAAE;YAC1H,OAAO,CAAC,GAA8B,EAAE,IAAI,EAAE,KAAK,EAAE;gBACnD,YAAY;gBACZ,WAAW;aACZ,CAAC,CAAA;YACF,+BAA+B;YAC/B,eAAe,CAAC,IAAI,EAAE,CAAC,UAAU,IAAI,GAAG,CAAmB,CAAC,CAAA;YAC5D,WAAW;YACX,IAAI,aAAa,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC;gBAC5C,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,UAAU,IAAI,GAAG,CAAmB,CAAC,CAAA;YACnE,CAAC;QACH,CAAC;KACwB,CAAA;IAE3B,wBAAwB;IACxB,sBAAsB,CAAC,GAAqB,CAAC,CAAA;IAE7C,uBAAuB;IACvB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAgC,CAA2B,CAAA;IAEvF,4BAA4B;IAC5B,UAAU,GAAG,OAAO,CAAA;IAEpB,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAA8B;IACvD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,+BAA+B;gBACpD,yEAAyE,CAC1E,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runtime 模块导出
+ */
+export { createRuntimeContext } from './create-context.js';
+export { createProxy } from './proxy.js';
+export { createExpressionSandbox, isSafePropertyAccess } from './sandbox.js';
+export { createLoopContext, releaseLoopContext, getLoopContextPool, clearLoopContextPool } from './loop-context-pool.js';
+export type { RuntimeContext } from '../types.js';
+export { parsePath, parsePathCached, clearPathCache, stringifyPath, getPathValue, setPathValue, matchPath, getParentPath, getLastSegment, type PathSegment } from './path.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EACd,KAAK,WAAW,EACjB,MAAM,WAAW,CAAA"}

package/dist/runtime/index.js

@@ -0,0 +1,10 @@
+/**
+ * Runtime 模块导出
+ */
+export { createRuntimeContext } from './create-context.js';
+export { createProxy } from './proxy.js';
+export { createExpressionSandbox, isSafePropertyAccess } from './sandbox.js';
+export { createLoopContext, releaseLoopContext, getLoopContextPool, clearLoopContextPool } from './loop-context-pool.js';
+// 路径工具（供框架集成层使用）
+export { parsePath, parsePathCached, clearPathCache, stringifyPath, getPathValue, setPathValue, matchPath, getParentPath, getLastSegment } from './path.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAC5E,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAG/B,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EAEf,MAAM,WAAW,CAAA"}

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"}