@lytjs/renderer 3.1.0

package/dist/types/miniapp/miniapp-renderer.d.ts

@@ -0,0 +1,269 @@
+/**
+ * MiniAppRenderer - 小程序渲染器原型
+ *
+ * 将 VNode 编译为小程序模板描述（可用于微信/支付宝/字节跳动小程序）。
+ * 纯原生零依赖 TypeScript 实现。
+ *
+ * 设计思路：
+ *   - 不直接操作 DOM，而是生成描述性的 MiniAppNode 树
+ *   - MiniAppNode 可序列化为 WXML / AXML / TTML 模板字符串
+ *   - 提供 Lyt.js 模板语法到小程序模板语法的转换
+ *   - 支持条件渲染（wx:if / a:if / tt:if）、列表渲染（wx:for / a:for / tt:for）
+ */
+import type { LytRenderer } from '../renderer-interfaces';
+/**
+ * 小程序模板节点描述
+ *
+ * 描述一棵小程序模板组件树，可序列化为各平台模板字符串。
+ */
+export interface MiniAppNode {
+    /** 标签名（如 'view', 'text', 'image'） */
+    tag: string;
+    /** 属性集合 */
+    attrs: Record<string, string>;
+    /** 子节点列表 */
+    children: MiniAppNode[];
+    /** 文本内容（文本节点使用） */
+    text?: string;
+    /** wx:if 条件表达式 */
+    wxIf?: string;
+    /** wx:for 列表数据源 */
+    wxFor?: string;
+    /** wx:key 列表项标识 */
+    wxForKey?: string;
+    /** 绑定事件（如 bindtap="handleTap"） */
+    bindEvents: Record<string, string>;
+    /** 双向绑定（如 model:value="name"） */
+    modelBindings: Record<string, string>;
+    /** 父节点引用（内部使用，不序列化） */
+    _parent?: MiniAppNode;
+}
+/**
+ * MiniAppRenderer - 小程序渲染器
+ *
+ * 实现 LytRenderer 接口，将 VNode 映射为小程序模板描述树。
+ * 不依赖任何外部库，纯 TypeScript 实现。
+ *
+ * 使用示例：
+ * ```ts
+ * import { miniAppRenderer } from './miniapp/miniapp-renderer'
+ *
+ * // 创建小程序节点
+ * const view = miniAppRenderer.createElement('div')
+ * miniAppRenderer.setAttribute(view, 'class', 'container')
+ *
+ * const text = miniAppRenderer.createText('Hello MiniApp')
+ * miniAppRenderer.insert(view, text)
+ *
+ * // 序列化为 WXML（微信小程序模板）
+ * const wxml = miniAppRenderer.serializeToWXML(view)
+ * ```
+ */
+export declare class MiniAppRenderer implements LytRenderer {
+    /**
+     * 创建小程序元素节点
+     * @param tag HTML 标签名（如 'div', 'span'）
+     * @returns MiniAppNode 描述对象
+     */
+    createElement(tag: string): MiniAppNode;
+    /**
+     * 创建文本节点
+     * @param text 文本内容
+     * @returns tag 为 '__text__' 的 MiniAppNode
+     */
+    createText(text: string): MiniAppNode;
+    /**
+     * 创建注释节点
+     * @param text 注释内容
+     * @returns tag 为 '__comment__' 的 MiniAppNode
+     */
+    createComment(text: string): MiniAppNode;
+    /**
+     * 设置元素属性
+     * @param el  小程序节点
+     * @param key 属性名
+     * @param val 属性值
+     */
+    setAttribute(el: MiniAppNode, key: string, val: any): void;
+    /**
+     * 移除元素属性
+     * @param el  小程序节点
+     * @param key 属性名
+     */
+    removeAttribute(el: MiniAppNode, key: string): void;
+    /**
+     * 设置元素样式
+     * @param el    小程序节点
+     * @param style 样式对象
+     */
+    setStyle(el: MiniAppNode, style: object): void;
+    /**
+     * 设置元素 class
+     * @param el  小程序节点
+     * @param cls class 值（字符串或对象）
+     */
+    setClass(el: MiniAppNode, cls: string | object): void;
+    /**
+     * 插入子节点
+     * @param parent 父节点
+     * @param child  子节点
+     * @param ref    参考节点（插入到其前面），可选
+     */
+    insert(parent: MiniAppNode, child: MiniAppNode, ref?: MiniAppNode): void;
+    /**
+     * 移除节点
+     * @param child 要移除的节点
+     */
+    remove(child: MiniAppNode): void;
+    /**
+     * 替换子节点
+     * @param parent   父节点
+     * @param oldChild 被替换的旧节点
+     * @param newChild 替换的新节点
+     */
+    replace(parent: MiniAppNode, oldChild: MiniAppNode, newChild: MiniAppNode): void;
+    /**
+     * 添加事件监听器
+     * @param el      小程序节点
+     * @param event   DOM 事件名（如 'click'）
+     * @param handler 事件处理函数
+     * @param options 事件选项（可选）
+     */
+    addEventListener(el: MiniAppNode, event: string, handler: Function, options?: any): void;
+    /**
+     * 移除事件监听器
+     * @param el      小程序节点
+     * @param event   DOM 事件名
+     * @param handler 事件处理函数
+     */
+    removeEventListener(el: MiniAppNode, event: string, handler: Function): void;
+    /**
+     * 在下一个微任务中执行回调
+     * @param cb 回调函数
+     */
+    nextTick(cb: Function): void;
+    /**
+     * 获取父节点
+     * @param el 小程序节点
+     * @returns 父节点，无父节点时返回 null
+     */
+    parentNode(el: MiniAppNode): MiniAppNode | null;
+    /**
+     * 获取下一个兄弟节点
+     * @param el 小程序节点
+     * @returns 下一个兄弟节点，无时返回 null
+     */
+    nextSibling(el: MiniAppNode): MiniAppNode | null;
+    /**
+     * 设置文本节点内容
+     * @param node 文本节点
+     * @param text 文本内容
+     */
+    setText(node: MiniAppNode, text: string): void;
+    /**
+     * 更新元素属性（diff 算法调用）
+     *
+     * @param el        小程序节点
+     * @param key       属性名
+     * @param prevValue 旧属性值
+     * @param nextValue 新属性值
+     */
+    patchProp(el: MiniAppNode, key: string, prevValue: any, nextValue: any): void;
+    /**
+     * 查询选择器（原型简化实现）
+     * @param selector CSS 选择器
+     * @returns 匹配的第一个节点，未找到返回 null
+     */
+    querySelector(selector: string): MiniAppNode | null;
+    /**
+     * 将 VNode 树转换为小程序节点树
+     *
+     * 递归遍历 VNode，将每个节点转换为对应的 MiniAppNode 描述。
+     *
+     * @param vnode VNode 对象
+     * @returns MiniAppNode 树
+     */
+    renderToMiniAppTree(vnode: any): MiniAppNode;
+    /**
+     * 序列化为 WXML（微信小程序模板）
+     *
+     * @param node    小程序节点
+     * @param indent  缩进级别（默认 0）
+     * @returns WXML 模板字符串
+     */
+    serializeToWXML(node: MiniAppNode, indent?: number): string;
+    /**
+     * 序列化为 AXML（支付宝小程序模板）
+     *
+     * @param node    小程序节点
+     * @param indent  缩进级别（默认 0）
+     * @returns AXML 模板字符串
+     */
+    serializeToAXML(node: MiniAppNode, indent?: number): string;
+    /**
+     * 序列化为 TTML（字节跳动小程序模板）
+     *
+     * @param node    小程序节点
+     * @param indent  缩进级别（默认 0）
+     * @returns TTML 模板字符串
+     */
+    serializeToTTML(node: MiniAppNode, indent?: number): string;
+    /**
+     * 根据平台获取模板字符串
+     *
+     * @param node     小程序节点
+     * @param platform 平台标识：'wechat' | 'alipay' | 'bytedance'
+     * @returns 对应平台的模板字符串
+     */
+    getPlatformTemplate(node: MiniAppNode, platform: 'wechat' | 'alipay' | 'bytedance'): string;
+    /**
+     * 将 Lyt.js 指令映射为小程序模板属性
+     *
+     * @param lytDirective Lyt.js 指令名（如 'if', 'each'）
+     * @param value        指令值
+     * @param platform     平台标识
+     * @returns 小程序模板属性字符串（如 'wx:if="{{condition}}"'）
+     */
+    mapDirective(lytDirective: string, value: string, platform?: string): string;
+    /**
+     * 将 Lyt.js 事件映射为小程序事件绑定
+     *
+     * @param lytEvent Lyt.js 事件名（如 'click'）
+     * @param platform 平台标识
+     * @returns 小程序事件绑定字符串（如 'bindtap'）
+     */
+    mapEvent(lytEvent: string, platform?: string): string;
+    /**
+     * 应用 Lyt.js 指令到节点
+     */
+    private _applyDirective;
+    /**
+     * 将样式对象转换为内联样式字符串
+     */
+    private _styleObjectToString;
+    /**
+     * 通用模板序列化方法
+     *
+     * @param node     小程序节点
+     * @param indent   缩进级别
+     * @param platform 平台标识
+     * @returns 模板字符串
+     */
+    private _serializeToTemplate;
+}
+/**
+ * 支持的小程序平台类型
+ */
+export type MiniAppPlatform = 'wechat' | 'alipay' | 'bytedance';
+/**
+ * 创建小程序渲染器实例
+ *
+ * 工厂函数，每次调用返回一个新的 MiniAppRenderer 实例。
+ * 适用于需要多个独立渲染器实例的场景。
+ *
+ * @returns MiniAppRenderer 实例
+ */
+export declare function createMiniAppRenderer(): MiniAppRenderer;
+/** 小程序渲染器单例 */
+export declare const miniAppRenderer: MiniAppRenderer;
+//# sourceMappingURL=miniapp-renderer.d.ts.map

package/dist/types/miniapp/miniapp-renderer.d.ts.map

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

package/dist/types/mount.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Lyt.js 渲染器 — 挂载逻辑
+ *
+ * 本模块包含 VNode 挂载相关的函数。
+ */
+import type { LytRenderer } from './renderer-interfaces';
+import type { VNode } from './vnode';
+/**
+ * 挂载 VNode
+ */
+export declare function mountVNode(renderer: LytRenderer, patchFn: PatchFn, vnode: VNode, container: any, anchor: any, parentComponent: any): void;
+/**
+ * 挂载元素节点
+ */
+export declare function mountElement(renderer: LytRenderer, patchFn: PatchFn, vnode: VNode, container: any, anchor: any, parentComponent: any): void;
+/**
+ * 批量挂载子节点
+ */
+export declare function mountChildren(patchFn: PatchFn, children: VNode[], container: any, anchor: any, parentComponent: any): void;
+/**
+ * 挂载 Fragment
+ */
+export declare function mountFragment(renderer: LytRenderer, patchFn: PatchFn, vnode: VNode, container: any, anchor: any, parentComponent: any): void;
+/**
+ * 挂载组件（简化版）
+ */
+export declare function mountComponent(patchFn: PatchFn, vnode: VNode, container: any, anchor: any, parentComponent: any): void;
+/**
+ * Patch 函数类型签名
+ */
+export type PatchFn = (n1: VNode | null, n2: VNode, container: any, anchor: any, parentComponent: any) => void;
+//# sourceMappingURL=mount.d.ts.map

package/dist/types/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/mount.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAIpC;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,GAAG,EACX,eAAe,EAAE,GAAG,GACnB,IAAI,CAoCN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,GAAG,EACX,eAAe,EAAE,GAAG,GACnB,IAAI,CA0BN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,KAAK,EAAE,EACjB,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,GAAG,EACX,eAAe,EAAE,GAAG,GACnB,IAAI,CAIN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,GAAG,EACX,eAAe,EAAE,GAAG,GACnB,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,GAAG,EACX,eAAe,EAAE,GAAG,GACnB,IAAI,CAWN;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,EAAE,EAAE,KAAK,GAAG,IAAI,EAChB,EAAE,EAAE,KAAK,EACT,SAAS,EAAE,GAAG,EACd,MAAM,EAAE,GAAG,EACX,eAAe,EAAE,GAAG,KACjB,IAAI,CAAA"}

package/dist/types/native/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 移动端渲染器 — 统一导出
+ */
+export { NativeRenderer, nativeRenderer, createNativeRenderer } from './native-renderer';
+export type { NativeNode, LytRendererPlatform } from './native-renderer';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/native/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/native/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxF,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/types/native/native-renderer.d.ts

@@ -0,0 +1,249 @@
+/**
+ * NativeRenderer - 移动端渲染器原型
+ *
+ * 将 VNode 映射为原生组件描述对象（可用于 React Native / Flutter / 原生 SDK 桥接）。
+ * 纯原生零依赖 TypeScript 实现。
+ *
+ * 设计思路：
+ *   - 不直接操作 DOM，而是生成描述性的 NativeNode 树
+ *   - NativeNode 可序列化为 JSON，通过 JS Bridge 传递给原生端
+ *   - 提供 HTML 标签到原生组件的映射、CSS 样式到原生样式的转换
+ */
+import type { LytRenderer } from '../renderer-interfaces';
+/**
+ * LytRendererPlatform 标准接口
+ *
+ * 所有平台渲染器必须实现此接口。
+ * 定义了渲染器与虚拟 DOM diff 算法对接所需的最小操作集。
+ */
+export interface LytRendererPlatform {
+    createElement(tag: string): any;
+    createText(text: string): any;
+    createComment(text: string): any;
+    insert(child: any, parent: any, anchor?: any): void;
+    remove(child: any): void;
+    patchProp(el: any, key: string, prevValue: any, nextValue: any): void;
+    parentNode(child: any): any | null;
+    nextSibling(child: any): any | null;
+    setText(node: any, text: string): void;
+}
+/**
+ * 原生节点描述
+ *
+ * 描述一棵原生 UI 组件树，可序列化为 JSON 供原生端消费。
+ */
+export interface NativeNode {
+    /** 原生组件类型（如 View, Text, Image） */
+    type: string;
+    /** 原生属性（包含样式、事件等） */
+    props: Record<string, any>;
+    /** 子节点列表 */
+    children: NativeNode[];
+    /** 原生视图标识，用于桥接时定位组件 */
+    nativeId?: string;
+    /** 父节点引用（内部使用，不序列化） */
+    _parent?: NativeNode;
+}
+/**
+ * NativeRenderer - 移动端渲染器
+ *
+ * 实现 LytRenderer 接口，将 VNode 映射为原生组件描述树。
+ * 不依赖任何外部库，纯 TypeScript 实现。
+ *
+ * 使用示例：
+ * ```ts
+ * import { nativeRenderer } from './native/native-renderer'
+ *
+ * // 创建原生节点
+ * const view = nativeRenderer.createElement('div')
+ * nativeRenderer.setAttribute(view, 'style', { flexDirection: 'row' })
+ *
+ * const text = nativeRenderer.createText('Hello Native')
+ * nativeRenderer.insert(view, text)
+ *
+ * // 序列化为 JSON（用于桥接传输）
+ * const json = nativeRenderer.serializeToJSON(view)
+ * ```
+ */
+export declare class NativeRenderer implements LytRenderer {
+    /**
+     * 创建原生元素节点
+     * @param tag HTML 标签名（如 'div', 'span'）
+     * @returns NativeNode 描述对象
+     */
+    createElement(tag: string): NativeNode;
+    /**
+     * 创建文本节点
+     * @param text 文本内容
+     * @returns 类型为 'RawText' 的 NativeNode
+     */
+    createText(text: string): NativeNode;
+    /**
+     * 创建注释节点
+     * @param text 注释内容
+     * @returns 类型为 '__Comment' 的 NativeNode（原生端通常忽略）
+     */
+    createComment(text: string): NativeNode;
+    /**
+     * 设置元素属性
+     * @param el  原生节点
+     * @param key 属性名
+     * @param val 属性值
+     */
+    setAttribute(el: NativeNode, key: string, val: any): void;
+    /**
+     * 移除元素属性
+     * @param el  原生节点
+     * @param key 属性名
+     */
+    removeAttribute(el: NativeNode, key: string): void;
+    /**
+     * 设置元素样式
+     * @param el    原生节点
+     * @param style 样式对象
+     */
+    setStyle(el: NativeNode, style: object): void;
+    /**
+     * 设置元素 class
+     * @param el  原生节点
+     * @param cls class 值（字符串或对象）
+     */
+    setClass(el: NativeNode, cls: string | object): void;
+    /**
+     * 插入子节点
+     * @param parent 父节点
+     * @param child  子节点
+     * @param ref    参考节点（插入到其前面），可选
+     */
+    insert(parent: NativeNode, child: NativeNode, ref?: NativeNode): void;
+    /**
+     * 移除节点
+     * @param child 要移除的节点
+     */
+    remove(child: NativeNode): void;
+    /**
+     * 替换子节点
+     * @param parent   父节点
+     * @param oldChild 被替换的旧节点
+     * @param newChild 替换的新节点
+     */
+    replace(parent: NativeNode, oldChild: NativeNode, newChild: NativeNode): void;
+    /**
+     * 添加事件监听器
+     * @param el      原生节点
+     * @param event   DOM 事件名（如 'click'）
+     * @param handler 事件处理函数
+     * @param options 事件选项（可选）
+     */
+    addEventListener(el: NativeNode, event: string, handler: Function, options?: any): void;
+    /**
+     * 移除事件监听器
+     * @param el      原生节点
+     * @param event   DOM 事件名
+     * @param handler 事件处理函数
+     */
+    removeEventListener(el: NativeNode, event: string, handler: Function): void;
+    /**
+     * 在下一个微任务中执行回调
+     * @param cb 回调函数
+     */
+    nextTick(cb: Function): void;
+    /**
+     * 获取父节点
+     * @param el 原生节点
+     * @returns 父节点，无父节点时返回 null
+     */
+    parentNode(el: NativeNode): NativeNode | null;
+    /**
+     * 获取下一个兄弟节点
+     * @param el 原生节点
+     * @returns 下一个兄弟节点，无时返回 null
+     */
+    nextSibling(el: NativeNode): NativeNode | null;
+    /**
+     * 设置文本节点内容
+     * @param node 文本节点
+     * @param text 文本内容
+     */
+    setText(node: NativeNode, text: string): void;
+    /**
+     * 更新元素属性（diff 算法调用）
+     *
+     * 当 prevValue 为 null/undefined 时表示新增属性，
+     * 当 nextValue 为 null/undefined 时表示移除属性，
+     * 否则表示更新属性。
+     *
+     * @param el        原生节点
+     * @param key       属性名
+     * @param prevValue 旧属性值
+     * @param nextValue 新属性值
+     */
+    patchProp(el: NativeNode, key: string, prevValue: any, nextValue: any): void;
+    /**
+     * 查询选择器（原型简化实现）
+     * @param selector CSS 选择器（仅支持 tag 选择器）
+     * @returns 匹配的第一个节点，未找到返回 null
+     */
+    querySelector(selector: string): NativeNode | null;
+    /**
+     * 将 VNode 树转换为原生节点树
+     *
+     * 递归遍历 VNode，将每个节点转换为对应的 NativeNode 描述。
+     *
+     * @param vnode VNode 对象
+     * @returns NativeNode 树
+     */
+    renderToNativeTree(vnode: any): NativeNode;
+    /**
+     * 序列化 NativeNode 为 JSON 字符串
+     *
+     * 用于调试输出或通过 JS Bridge 传递给原生端。
+     * 序列化时会过滤掉内部字段（_parent）。
+     *
+     * @param node 原生节点
+     * @returns JSON 字符串
+     */
+    serializeToJSON(node: NativeNode): string;
+    /**
+     * 获取原生组件类型
+     *
+     * 将 HTML 标签名映射为原生组件类型名。
+     * 未在映射表中的标签会使用 PascalCase 转换。
+     *
+     * @param tag HTML 标签名
+     * @returns 原生组件类型名
+     */
+    getComponentType(tag: string): string;
+    /**
+     * CSS 样式转原生样式
+     *
+     * 将 CSS 样式对象转换为原生样式对象。
+     * 支持数值自动转换（如 '10px' → 10）。
+     *
+     * @param cssStyle CSS 样式对象
+     * @returns 原生样式对象
+     */
+    mapStyle(cssStyle: Record<string, string>): Record<string, any>;
+    /**
+     * DOM 事件转原生事件
+     *
+     * 将 Web DOM 事件名映射为原生平台事件名。
+     * 未在映射表中的事件会添加 'on' 前缀并首字母大写。
+     *
+     * @param domEvent DOM 事件名（如 'click'）
+     * @returns 原生事件名（如 'onPress'）
+     */
+    mapEvent(domEvent: string): string;
+}
+/**
+ * 创建原生渲染器实例
+ *
+ * 工厂函数，每次调用返回一个新的 NativeRenderer 实例。
+ * 适用于需要多个独立渲染器实例的场景。
+ *
+ * @returns NativeRenderer 实例
+ */
+export declare function createNativeRenderer(): NativeRenderer;
+/** 移动端渲染器单例 */
+export declare const nativeRenderer: NativeRenderer;
+//# sourceMappingURL=native-renderer.d.ts.map

package/dist/types/native/native-renderer.d.ts.map

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

package/dist/types/patch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Lyt.js 渲染器 — Patch 逻辑
+ *
+ * 本模块包含 VNode 对比更新的核心函数。
+ */
+import type { LytRenderer } from './renderer-interfaces';
+import type { VNode } from './vnode';
+import { type PatchFn } from './mount';
+/**
+ * Patch 主函数 — 对比新旧 VNode 并更新
+ *
+ * @param n1    旧 VNode（null 表示首次挂载）
+ * @param n2    新 VNode
+ * @param container 父容器
+ * @param anchor    插入锚点
+ * @param parentComponent 父组件实例
+ */
+export declare function patch(renderer: LytRenderer, unmountFn: (vnode: VNode, container?: any) => void, n1: VNode | null, n2: VNode, container: any, anchor?: any, parentComponent?: any): void;
+/**
+ * 创建一个绑定 renderer 和 unmountFn 的 patch 函数
+ */
+export declare function createPatchFn(renderer: LytRenderer, unmountFn: (vnode: VNode, container?: any) => void): PatchFn;
+//# sourceMappingURL=patch.d.ts.map

package/dist/types/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../src/patch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAGpC,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AAIjE;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CACnB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,IAAI,EAClD,EAAE,EAAE,KAAK,GAAG,IAAI,EAChB,EAAE,EAAE,KAAK,EACT,SAAS,EAAE,GAAG,EACd,MAAM,GAAE,GAAU,EAClB,eAAe,GAAE,GAAU,GAC1B,IAAI,CAmEN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,IAAI,GACjD,OAAO,CAIT"}

package/dist/types/props.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lyt.js 渲染器 — 属性处理
+ *
+ * 本模块包含属性挂载和更新的相关函数。
+ */
+import type { LytRenderer } from './renderer-interfaces';
+/**
+ * 挂载单个 prop
+ */
+export declare function mountProp(renderer: LytRenderer, el: any, key: string, value: any): void;
+/**
+ * 更新单个 prop
+ */
+export declare function patchSingleProp(renderer: LytRenderer, el: any, key: string, newValue: any, oldValue: any): void;
+/**
+ * 全量对比更新所有 props
+ */
+export declare function patchAllProps(renderer: LytRenderer, el: any, oldProps: Record<string, any>, newProps: Record<string, any>): void;
+//# sourceMappingURL=props.d.ts.map

package/dist/types/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAExD;;GAEG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,WAAW,EACrB,EAAE,EAAE,GAAG,EACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,GAAG,GACT,IAAI,CAgBN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,WAAW,EACrB,EAAE,EAAE,GAAG,EACP,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,GAAG,EACb,QAAQ,EAAE,GAAG,GACZ,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,EAAE,EAAE,GAAG,EACP,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,IAAI,CA6BN"}