@lytjs/renderer 3.1.0

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

@@ -0,0 +1,292 @@
+/**
+ * Lyt.js SSR 字符串渲染器
+ *
+ * 将 VNode 树渲染为 HTML 字符串，用于服务端渲染（SSR）场景。
+ * 纯原生零依赖实现，不依赖任何外部库。
+ *
+ * 核心功能：
+ *   - renderToString(vnode) — 将 VNode 树同步序列化为完整 HTML 字符串
+ *   - renderToStream(vnode, options?) — 将 VNode 树异步流式序列化（逐步输出 HTML）
+ *   - createElement(tag) — 创建轻量描述对象（SSR 环境无真实 DOM）
+ *   - createText(text) — 创建文本描述对象
+ *   - insert(parent, child) — 将子节点添加到父节点的 children 数组
+ *
+ * 支持的 VNode 类型：
+ *   - Element VNode：输出 HTML 标签 + 属性 + 子节点
+ *   - Text VNode：输出转义后的文本内容
+ *   - Comment VNode：输出 HTML 注释 <!-- -->
+ *   - Fragment VNode：只输出子节点（无包裹标签）
+ *   - Component VNode（函数式/有状态）：递归渲染组件 render 函数输出
+ *   - Slot VNode：渲染插槽内容
+ *   - Null/Undefined：不输出任何内容
+ *
+ * 特殊处理：
+ *   - class/style/event 属性的序列化
+ *   - 自闭合标签（br/hr/img/input 等）
+ *   - HTML 转义（防 XSS）
+ *   - Fragment 多根节点支持
+ *   - data-* 自定义属性
+ *   - aria-* 无障碍属性
+ *   - dangerouslySetInnerHTML 支持
+ *   - Suspense 组件集成（流式渲染 fallback → resolved）
+ *   - Islands Architecture（Partial Hydration）标记支持
+ */
+/** SSR 轻量元素描述对象 */
+export interface SSRVNode {
+    /** 标签名 */
+    tag: string;
+    /** 属性 */
+    props: Record<string, any>;
+    /** 子节点 */
+    children: (SSRVNode | SSRTextVNode)[];
+}
+/** SSR 文本描述对象 */
+export interface SSRTextVNode {
+    /** 类型标记 */
+    type: 'text';
+    /** 文本内容 */
+    value: string;
+}
+/** VNode 兼容类型（与 @lytjs/vdom 和 @lytjs/renderer 的 VNode 对齐） */
+export interface VNode {
+    type: string | object | symbol;
+    props: Record<string, any> | null;
+    children: string | VNode[] | Record<string, any> | null;
+    key: string | number | null;
+    ref: any;
+    shapeFlag: number;
+    patchFlag: number;
+    dynamicChildren: VNode[] | null;
+    dynamicProps: string[] | null;
+    component: any;
+    el: any;
+    anchor: any;
+    [key: string]: any;
+}
+/** 组件类型接口（有状态组件） */
+export interface ComponentOptions {
+    /** 组件名称 */
+    name?: string;
+    /** setup 函数 */
+    setup?: (...args: any[]) => any;
+    /** render 函数 */
+    render?: (...args: any[]) => VNode;
+    /** props 定义 */
+    props?: Record<string, any>;
+    /** slots */
+    slots?: Record<string, any>;
+    /** 其他组件选项 */
+    [key: string]: any;
+}
+/** renderToStream 选项 */
+export interface RenderToStreamOptions {
+    /** Suspense 边界 ID 前缀，默认 'suspense' */
+    suspenseIdPrefix?: string;
+}
+/**
+ * HTML 转义 — 将特殊字符替换为 HTML 实体
+ *
+ * 防止 XSS 攻击，确保用户输入的内容不会被当作 HTML 解析。
+ *
+ * @param str 需要转义的字符串
+ * @returns 转义后的安全字符串
+ *
+ * @example
+ *   escapeHTML('<script>alert("xss")</script>')
+ *   // → '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;'
+ */
+export declare function escapeHTML(str: string): string;
+/**
+ * 序列化属性值为字符串
+ *
+ * 对不同类型的属性值进行特殊处理：
+ *   - class：支持字符串、数组、对象形式
+ *   - style：支持字符串、对象形式
+ *   - 事件（on*）：SSR 环境下不序列化事件
+ *   - ref/key：内部属性，不序列化
+ *   - innerHTML/dangerouslySetInnerHTML：特殊处理
+ *   - data-* 属性：直接序列化
+ *   - aria-* 属性：直接序列化
+ *   - 布尔属性：值为 true 时只输出属性名
+ *   - 其他：直接转为字符串
+ *
+ * @param key   属性名
+ * @param value 属性值
+ * @returns 序列化后的属性字符串（格式：key="value"），不需要序列化时返回空字符串
+ */
+export declare function serializeProp(key: string, value: any): string;
+/**
+ * 标准化 class 值
+ *
+ * 支持多种形式的 class 输入：
+ *   - 字符串：'foo bar'
+ *   - 数组：['foo', 'bar']
+ *   - 对象：{ foo: true, bar: false }
+ *   - 混合：['foo', { bar: true }]
+ *
+ * @param value class 值
+ * @returns 标准化后的 class 字符串
+ */
+export declare function normalizeClass(value: any): string;
+/**
+ * 标准化 style 值
+ *
+ * 支持两种形式的 style 输入：
+ *   - 字符串：'color: red; font-size: 14px'
+ *   - 对象：{ color: 'red', fontSize: '14px' }
+ *
+ * @param value style 值
+ * @returns 标准化后的 style 字符串
+ */
+export declare function normalizeStyle(value: any): string;
+/**
+ * 序列化所有属性
+ *
+ * 将 props 对象转换为 HTML 属性字符串
+ *
+ * @param props 属性对象
+ * @returns HTML 属性字符串（如 'class="foo" id="bar"'）
+ */
+export declare function serializeProps(props: Record<string, any> | null): string;
+/**
+ * SSR 字符串渲染器
+ *
+ * 将 VNode 树渲染为 HTML 字符串。实现了 LytRenderer 接口的 SSR 版本。
+ * 在 SSR 环境中，没有真实 DOM，所有操作都是基于轻量描述对象。
+ *
+ * @example
+ *   const renderer = new StringRenderer()
+ *   const parent = renderer.createElement('div')
+ *   const child = renderer.createText('Hello')
+ *   renderer.insert(parent, child)
+ *   // parent.children = [{ type: 'text', value: 'Hello' }]
+ */
+export declare class StringRenderer {
+    /**
+     * 创建元素节点
+     *
+     * SSR 环境中没有真实 DOM，返回轻量描述对象。
+     *
+     * @param tag 标签名（如 'div', 'span'）
+     * @returns 轻量元素描述对象
+     */
+    createElement(tag: string): SSRVNode;
+    /**
+     * 创建文本节点
+     *
+     * @param text 文本内容
+     * @returns 文本描述对象
+     */
+    createText(text: string): SSRTextVNode;
+    /**
+     * 创建注释节点
+     *
+     * SSR 中注释节点用文本描述对象表示
+     *
+     * @param text 注释内容
+     * @returns 注释描述对象
+     */
+    createComment(text: string): SSRTextVNode;
+    /**
+     * 插入子节点到父节点
+     *
+     * SSR 中简单地将子节点添加到父节点的 children 数组。
+     *
+     * @param parent 父节点
+     * @param child  子节点
+     * @param _ref   参考节点（SSR 中忽略）
+     */
+    insert(parent: SSRVNode, child: SSRVNode | SSRTextVNode, _ref?: any): void;
+    /**
+     * 将 VNode 渲染为 HTML 字符串（同步）
+     *
+     * 递归遍历 VNode 树，将每个节点序列化为对应的 HTML 字符串。
+     *
+     * @param vnode VNode 节点
+     * @returns 完整的 HTML 字符串
+     *
+     * @example
+     *   const vnode = {
+     *     type: 'div',
+     *     props: { class: 'app', id: 'root' },
+     *     children: [
+     *       { type: 'span', props: null, children: 'Hello', shapeFlag: 8 },
+     *     ],
+     *     shapeFlag: 17, // ELEMENT | ARRAY_CHILDREN
+     *   }
+     *   renderToString(vnode)
+     *   // → '<div class="app" id="root"><span>Hello</span></div>'
+     */
+    renderToString(vnode: VNode): string;
+    /**
+     * 将 VNode 渲染为异步生成器（流式渲染）
+     *
+     * 逐步输出 HTML 字符串片段，适用于大页面或需要尽早发送响应的场景。
+     * 每个节点渲染完成后立即 yield，而不是等待整棵树渲染完成。
+     *
+     * @param vnode VNode 节点
+     * @returns 异步生成器，逐步产出 HTML 字符串片段
+     *
+     * @example
+     *   for await (const chunk of renderer.renderToStream(vnode)) {
+     *     res.write(chunk)
+     *   }
+     *   res.end()
+     */
+    renderToStream(vnode: VNode): AsyncGenerator<string>;
+}
+/**
+ * 将 VNode 树渲染为完整 HTML 字符串（同步）
+ *
+ * 独立函数形式，方便直接调用而无需实例化 StringRenderer。
+ *
+ * @param vnode VNode 节点
+ * @returns 完整的 HTML 字符串
+ *
+ * @example
+ *   const html = renderToString(vnode)
+ *   // → '<div>Hello</div>'
+ */
+export declare function renderToString(vnode: VNode): string;
+/**
+ * 将 VNode 树异步流式渲染为 ReadableStream
+ *
+ * 返回一个 Node.js ReadableStream，逐步输出 HTML 字符串片段。
+ * 支持与 Suspense 集成：遇到 Suspense 边界时，先输出 fallback 内容，
+ * 异步组件解析完成后再输出真实内容（通过占位注释标记实现替换）。
+ *
+ * @param vnode   VNode 节点
+ * @param options 流式渲染选项
+ * @returns ReadableStream<string>，逐步产出 HTML 字符串片段
+ *
+ * @example
+ *   const stream = renderToStream(vnode)
+ *   // 在 Node.js HTTP 响应中使用
+ *   Readable.fromWeb(stream).pipe(res)
+ *
+ *   // 或手动消费
+ *   for await (const chunk of stream) {
+ *     process.stdout.write(chunk)
+ *   }
+ */
+export declare function renderToStream(vnode: VNode, options?: RenderToStreamOptions): ReadableStream<string>;
+/**
+ * 将 VNode 树异步流式渲染为异步生成器
+ *
+ * 与 renderToStream 类似，但返回 AsyncGenerator 而非 ReadableStream。
+ * 更轻量级，适合直接在 async 函数中使用 for-await-of 消费。
+ *
+ * @param vnode   VNode 节点
+ * @param options 流式渲染选项
+ * @yields HTML 字符串片段
+ *
+ * @example
+ *   for await (const chunk of renderToStreamGenerator(vnode)) {
+ *     res.write(chunk)
+ *   }
+ *   res.end()
+ */
+export declare function renderToStreamGenerator(vnode: VNode, options?: RenderToStreamOptions): AsyncGenerator<string>;
+/** 默认渲染器实例 */
+export declare const ssrRenderer: StringRenderer;
+//# sourceMappingURL=ssr-renderer.d.ts.map

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

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

package/dist/types/unmount.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lyt.js 渲染器 — 卸载逻辑
+ *
+ * 本模块包含 VNode 卸载相关的函数。
+ */
+import type { LytRenderer } from './renderer-interfaces';
+import type { VNode } from './vnode';
+/**
+ * 卸载 VNode
+ */
+export declare function unmount(renderer: LytRenderer, unmountFn: (vnode: VNode, container?: any) => void, vnode: VNode, container?: any): void;
+/**
+ * 批量卸载子节点
+ */
+export declare function unmountChildren(unmountFn: (vnode: VNode, container?: any) => void, children: VNode[]): void;
+//# sourceMappingURL=unmount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unmount.d.ts","sourceRoot":"","sources":["../../src/unmount.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAGpC;;GAEG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,IAAI,EAClD,KAAK,EAAE,KAAK,EACZ,SAAS,CAAC,EAAE,GAAG,GACd,IAAI,CA4BN;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,IAAI,EAClD,QAAQ,EAAE,KAAK,EAAE,GAChB,IAAI,CAIN"}

package/dist/types/vapor/vapor-compiler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Lyt.js Vapor Mode - 模板编译器
+ *
+ * 将 HTML 模板编译为直接 DOM 操作的渲染函数。
+ * 编译后的函数直接创建 DOM 元素并绑定信号，无需 VDOM 中间层。
+ *
+ * 支持的语法：
+ *   - 文本插值: {{ expression }}
+ *   - 事件绑定: on:event="handler"
+ *   - 属性绑定: :prop="expression"
+ *   - 条件渲染: v-if="expression"
+ *   - 列表渲染: v-each="item in expression"
+ */
+import type { VaporElement } from './vapor-reactive';
+/** 编译后的渲染函数 */
+export type VaporRenderFunction = (ctx: Record<string, any>) => VaporElement;
+/** AST 节点类型 */
+type ASTNodeType = 'element' | 'text' | 'interpolation' | 'fragment';
+/** AST 节点 */
+interface ASTNode {
+    type: ASTNodeType;
+    tag?: string;
+    text?: string;
+    expression?: string;
+    props?: Record<string, string>;
+    events?: Record<string, string>;
+    directives?: {
+        if?: string;
+        each?: {
+            item: string;
+            expression: string;
+        };
+    };
+    children?: ASTNode[];
+}
+/** 编译结果 */
+export interface VaporCompileResult {
+    /** 渲染函数 */
+    render: VaporRenderFunction;
+    /** AST（调试用） */
+    ast: ASTNode;
+}
+/**
+ * 简单的 HTML 模板解析器
+ *
+ * 将模板字符串解析为 AST 树。
+ */
+declare function parseTemplate(template: string): ASTNode;
+/**
+ * 将 AST 节点编译为渲染函数
+ *
+ * @param template  HTML 模板字符串
+ * @returns 编译结果
+ */
+export declare function compileToVapor(template: string): VaporCompileResult;
+/**
+ * 递归渲染 AST 节点为 DOM 元素
+ */
+declare function renderASTNode(node: ASTNode, ctx: Record<string, any>, factory: (tag: string) => VaporElement): VaporElement;
+/**
+ * 从上下文中解析表达式
+ *
+ * 支持简单属性访问和点号路径。
+ */
+declare function resolveExpression(ctx: Record<string, any>, expression: string): any;
+export { parseTemplate, renderASTNode, resolveExpression };
+//# sourceMappingURL=vapor-compiler.d.ts.map

package/dist/types/vapor/vapor-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vapor-compiler.d.ts","sourceRoot":"","sources":["../../../src/vapor/vapor-compiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAiBpD,eAAe;AACf,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,YAAY,CAAA;AAE5E,eAAe;AACf,KAAK,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,UAAU,CAAA;AAEpE,aAAa;AACb,UAAU,OAAO;IACf,IAAI,EAAE,WAAW,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,CAAC,EAAE;QACX,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAC5C,CAAA;IACD,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;CACrB;AAED,WAAW;AACX,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,MAAM,EAAE,mBAAmB,CAAA;IAC3B,eAAe;IACf,GAAG,EAAE,OAAO,CAAA;CACb;AAMD;;;;GAIG;AACH,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA8EhD;AA6GD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAInE;AAYD;;GAEG;AACH,iBAAS,aAAa,CACpB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,GACrC,YAAY,CAiId;AAED;;;;GAIG;AACH,iBAAS,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAwB5E;AAMD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/types/vapor/vapor-component.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Lyt.js Vapor Mode - 组件系统
+ *
+ * 提供 Vapor Mode 的组件定义和 App 创建功能。
+ * 与标准 defineComponent 类似，但使用 Vapor 渲染器（无 VDOM）。
+ */
+import type { VaporComponentOptions, VaporApp } from './vapor-renderer';
+import type { VaporElement } from './vapor-reactive';
+/** Vapor 组件实例 */
+export interface VaporComponentInstance {
+    /** 组件选项 */
+    options: VaporComponentOptions;
+    /** 组件上下文（setup 返回值） */
+    ctx: Record<string, any>;
+    /** 根 DOM 元素 */
+    el: VaporElement | null;
+    /** 是否已挂载 */
+    isMounted: boolean;
+    /** 卸载函数 */
+    _unmount?: () => void;
+}
+/**
+ * 定义 Vapor 组件
+ *
+ * 与 defineComponent 类似，但使用 Vapor Mode 渲染。
+ * 不创建 VDOM，直接操作 DOM。
+ *
+ * @param options  组件选项
+ * @returns 组件构造函数
+ */
+export declare function defineVaporComponent(options: VaporComponentOptions): VaporComponentOptions;
+/**
+ * 创建 Vapor Mode 应用
+ *
+ * 类似 createApp，但使用 Vapor 渲染器。
+ *
+ * @param rootComponent  根组件选项
+ * @returns VaporApp 实例
+ */
+export declare function createVaporApp(rootComponent: VaporComponentOptions): VaporApp;
+/**
+ * 渲染 Vapor 组件为 DOM 元素
+ *
+ * @param component  组件选项
+ * @returns 渲染后的 DOM 元素
+ */
+export declare function renderVaporComponent(component: VaporComponentOptions): VaporElement;
+//# sourceMappingURL=vapor-component.d.ts.map

package/dist/types/vapor/vapor-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vapor-component.d.ts","sourceRoot":"","sources":["../../../src/vapor/vapor-component.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAa,qBAAqB,EAAE,QAAQ,EAAkB,MAAM,kBAAkB,CAAA;AAElG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAOpD,iBAAiB;AACjB,MAAM,WAAW,sBAAsB;IACrC,WAAW;IACX,OAAO,EAAE,qBAAqB,CAAA;IAC9B,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACxB,eAAe;IACf,EAAE,EAAE,YAAY,GAAG,IAAI,CAAA;IACvB,YAAY;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW;IACX,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,CAE1F;AAMD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,qBAAqB,GAAG,QAAQ,CAoD7E;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,qBAAqB,GAAG,YAAY,CAgCnF"}

package/dist/types/vapor/vapor-reactive.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Lyt.js Vapor Mode - 响应式绑定
+ *
+ * 在 Vapor Mode 中，响应式信号直接绑定到 DOM 属性上，
+ * 无需虚拟 DOM 中间层。当信号值变化时，直接更新对应的 DOM 节点。
+ *
+ * 每个绑定函数返回一个清理函数，用于在卸载时取消订阅。
+ */
+import type { Signal } from '@lytjs/reactivity/signal';
+/** DOM 元素接口（兼容真实 DOM 和 Mock DOM） */
+export interface VaporElement {
+    tagName: string;
+    nodeType: number;
+    textContent: string;
+    className: string;
+    childNodes: VaporElement[];
+    parentNode: VaporElement | null;
+    style: Record<string, string> | CSSStyleDeclaration;
+    setAttribute(key: string, value: string): void;
+    removeAttribute(key: string): void;
+    addEventListener(event: string, handler: Function): void;
+    removeEventListener(event: string, handler: Function): void;
+    appendChild(child: VaporElement): void;
+    insertBefore(child: VaporElement, ref: VaporElement | null): void;
+    removeChild(child: VaporElement): void;
+    nextSibling: VaporElement | null;
+    firstChild: VaporElement | null;
+    innerHTML?: string;
+    hidden?: boolean;
+    value?: string;
+    checked?: boolean;
+    disabled?: boolean;
+    [key: string]: any;
+}
+/** 绑定清理函数 */
+export type BindingCleanup = () => void;
+/**
+ * 将信号值绑定到元素的 textContent
+ *
+ * @param el    目标 DOM 元素
+ * @param sig   响应式信号
+ * @returns 清理函数
+ */
+export declare function bindText(el: VaporElement, sig: Signal<any>): BindingCleanup;
+/**
+ * 将信号值绑定到元素的 DOM 属性（如 value, checked, disabled 等）
+ *
+ * @param el    目标 DOM 元素
+ * @param prop  属性名
+ * @param sig   响应式信号
+ * @returns 清理函数
+ */
+export declare function bindProp(el: VaporElement, prop: string, sig: Signal<any>): BindingCleanup;
+/**
+ * 将信号值绑定到元素的 HTML 属性（通过 setAttribute）
+ *
+ * @param el    目标 DOM 元素
+ * @param attr  属性名
+ * @param sig   响应式信号
+ * @returns 清理函数
+ */
+export declare function bindAttr(el: VaporElement, attr: string, sig: Signal<any>): BindingCleanup;
+/**
+ * 将信号值绑定到元素的 className
+ *
+ * 支持三种形式：
+ *   - 字符串：直接设置为 className
+ *   - 对象：{ active: true, disabled: false } -> "active"
+ *   - 数组：["class-a", "class-b"] -> "class-a class-b"
+ *
+ * @param el    目标 DOM 元素
+ * @param sig   响应式信号
+ * @returns 清理函数
+ */
+export declare function bindClass(el: VaporElement, sig: Signal<any>): BindingCleanup;
+/**
+ * 将事件处理器绑定到元素
+ *
+ * @param el      目标 DOM 元素
+ * @param event   事件名
+ * @param handler 事件处理函数
+ * @returns 清理函数
+ */
+export declare function bindEvent(el: VaporElement, event: string, handler: Function): BindingCleanup;
+/**
+ * 根据信号值控制元素的显示/隐藏
+ *
+ * 当信号值为真值时显示元素，假值时隐藏元素。
+ * 使用 display: none 方式隐藏，保留 DOM 结构。
+ *
+ * @param el    目标 DOM 元素
+ * @param sig   响应式信号
+ * @returns 清理函数
+ */
+export declare function bindIf(el: VaporElement, sig: Signal<any>): BindingCleanup;
+/**
+ * 根据信号数组渲染列表
+ *
+ * 当数组变化时，智能 diff 并更新 DOM。
+ * 使用 key 进行高效的增删改操作。
+ *
+ * @param container   容器元素
+ * @param sig         响应式信号（返回数组）
+ * @param renderItem  渲染单项的函数，接收 (item, index) 返回 VaporElement
+ * @param keyFn       可选的 key 提取函数，用于高效 diff
+ * @returns 清理函数
+ */
+export declare function bindEach<T>(container: VaporElement, sig: Signal<T[]>, renderItem: (item: T, index: number) => VaporElement, keyFn?: (item: T, index: number) => string | number): BindingCleanup;
+//# sourceMappingURL=vapor-reactive.d.ts.map

package/dist/types/vapor/vapor-reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vapor-reactive.d.ts","sourceRoot":"","sources":["../../../src/vapor/vapor-reactive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAOtD,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,UAAU,EAAE,YAAY,GAAG,IAAI,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,mBAAmB,CAAA;IACnD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9C,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAA;IACxD,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC3D,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IACtC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAA;IACjE,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IACtC,WAAW,EAAE,YAAY,GAAG,IAAI,CAAA;IAChC,UAAU,EAAE,YAAY,GAAG,IAAI,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,aAAa;AACb,MAAM,MAAM,cAAc,GAAG,MAAM,IAAI,CAAA;AAMvC;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GACf,cAAc,CAMhB;AAMD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GACf,cAAc,CAMhB;AAMD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,YAAY,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GACf,cAAc,CAUhB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GACf,cAAc,CAoBhB;AAMD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,GAChB,cAAc,CAKhB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CACpB,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,GACf,cAAc,CAgBhB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,SAAS,EAAE,YAAY,EACvB,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAChB,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,YAAY,EACpD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAClD,cAAc,CAsEhB"}