@lytjs/renderer 5.0.0 → 6.0.0

package/dist/types/ssr/hydration.d.ts

@@ -1,267 +0,0 @@
-/**
- * Lyt.js 客户端注水（Hydration）
- *
- * 在服务端渲染（SSR）后，客户端需要将静态 HTML "激活"为可交互的应用。
- * 注水过程会对比服务端渲染的 DOM 与客户端 VNode，复用已有 DOM 节点，
- * 仅绑定事件和响应式数据，避免重新创建 DOM。
- *
- * 核心机制：
- *   - hydrate(app, container) — 注水入口函数
- *   - 对比 DOM 节点与 VNode 的类型和属性
- *   - 复用匹配的 DOM 节点，绑定事件和响应式
- *   - isHydrating 标记区分注水模式和首次渲染
- *   - onHydrated 回调通知注水完成
- *
- * 注水流程：
- *   1. 遍历服务端渲染的 DOM 树
- *   2. 对比每个 DOM 节点与对应的客户端 VNode
- *   3. 如果匹配（标签名相同），复用 DOM 节点，绑定事件
- *   4. 如果不匹配，标记为 hydration mismatch（开发环境警告）
- *   5. 递归处理子节点
- *   6. 注水完成后触发 onHydrated 回调
- *
- * 支持的节点类型：
- *   - Element：对比标签名，绑定事件，递归子节点
- *   - Text：对比文本内容
- *   - Comment：对比注释内容
- *   - Fragment：直接注水子节点
- *   - Component：递归注水组件 subTree
- *
- * Partial Hydration（Islands Architecture）：
- *   - hydrateIsland(selector, component) — 选择性注水特定 island
- *   - createHydrationIsland(component, props) — 服务端生成 island HTML
- *   - 支持 lazy hydration（IntersectionObserver / requestIdleCallback / interaction）
- *   - 支持 hydration mismatch 检测（开发模式）
- */
-import type { VNode } from '@lytjs/vdom';
-/** 应用实例接口（简化版） */
-export interface App {
-    /** 挂载函数 */
-    mount: (container: Element) => void;
-    /** 卸载函数 */
-    unmount?: () => void;
-    /** 根组件 */
-    _component?: any;
-    /** 根 VNode */
-    _vnode?: VNode;
-}
-/** 注水选项 */
-export interface HydrateOptions {
-    /** 注水完成后的回调 */
-    onHydrated?: () => void;
-    /** 是否在 mismatch 时抛出错误（默认 false，只警告） */
-    strict?: boolean;
-}
-/** Partial Hydration 选项（Islands Architecture） */
-export interface HydrationOptions {
-    /** 仅注水特定 island 元素 */
-    hydrateIslands?: boolean;
-    /** 懒注水：元素进入视口时才注水 */
-    lazy?: boolean;
-    /** 注水超时时间（毫秒） */
-    timeout?: number;
-    /** 注水完成回调 */
-    onHydrated?: () => void;
-    /** 是否在 mismatch 时抛出错误（默认 false，只警告） */
-    strict?: boolean;
-    /** 开发模式（启用 mismatch 检测和警告） */
-    dev?: boolean;
-}
-/** 注水结果 */
-export interface HydrateResult {
-    /** 是否成功 */
-    success: boolean;
-    /** mismatch 数量 */
-    mismatches: number;
-    /** 注水的节点数量 */
-    hydratedNodes: number;
-}
-/**
- * 获取当前是否处于注水模式
- *
- * @returns 是否正在注水
- */
-export declare function isHydrating(): boolean;
-/**
- * 设置注水模式标记
- *
- * @param value 是否处于注水模式
- */
-export declare function setHydrating(value: boolean): void;
-/**
- * 获取注水统计信息
- *
- * @returns 注水结果统计
- */
-export declare function getHydrateStats(): HydrateResult;
-/**
- * 重置注水统计信息
- */
-export declare function resetHydrateStats(): void;
-/**
- * 注册注水完成回调
- *
- * @param cb 回调函数
- */
-export declare function onHydrated(cb: () => void): void;
-/**
- * 客户端注水函数
- *
- * 将服务端渲染的静态 HTML 激活为可交互的应用。
- * 对比 DOM 树与 VNode 树，复用已有 DOM 节点，仅绑定事件和响应式。
- *
- * @param app       应用实例
- * @param container 挂载容器（与服务端渲染的根元素对应）
- * @param options   注水选项
- * @returns 注水结果统计
- *
- * @example
- *   // 服务端渲染的 HTML
- *   // <div id="app"><h1>Hello</h1></div>
- *
- *   // 客户端注水
- *   import { createApp } from '@lytjs/core'
- *   import { hydrate } from '@lytjs/renderer/ssr'
- *   import App from './App'
- *
- *   const app = createApp(App)
- *   hydrate(app, document.getElementById('app')!, {
- *     onHydrated: () => console.log('注水完成')
- *   })
- */
-export declare function hydrate(app: App, container: Element, options?: HydrateOptions): HydrateResult;
-/**
- * 组件选项接口（用于 Island 注水）
- * 与 SSR 渲染器的 ComponentOptions 对齐
- */
-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;
-}
-/** Island 注水状态 */
-interface IslandState {
-    /** island 标识符 */
-    id: string;
-    /** 是否已注水 */
-    hydrated: boolean;
-    /** 组件实例 */
-    instance: any;
-    /** 事件监听器（用于清理） */
-    eventListeners: Array<{
-        el: HTMLElement;
-        event: string;
-        handler: any;
-    }>;
-    /** 超时定时器 */
-    timeoutId: ReturnType<typeof setTimeout> | null;
-    /** IntersectionObserver 实例 */
-    observer: IntersectionObserver | null;
-    /** 交互事件监听器 */
-    interactionHandler: (() => void) | null;
-}
-/**
- * 注水特定 island（Partial Hydration）
- *
- * 通过 CSS 选择器找到服务端渲染的 island 元素，
- * 解析其关联的 props JSON，创建组件实例并注水。
- *
- * @param selector  CSS 选择器（匹配带 data-hydrate 属性的元素）
- * @param component 组件定义
- * @param options   注水选项
- * @returns 注水结果
- *
- * @example
- *   // HTML: <div data-hydrate="counter" data-props="...">...</div>
- *   // <script type="application/json" data-hydrate-props="counter">{"count":0}</script>
- *   hydrateIsland('[data-hydrate="counter"]', CounterComponent)
- */
-export declare function hydrateIsland(selector: string, component: ComponentOptions, options?: HydrationOptions): HydrateResult;
-/**
- * 注水所有 island
- *
- * 查找页面上所有带 data-hydrate 属性的元素，逐一注水。
- * 需要提前通过 registerIslandComponent 注册组件映射。
- *
- * @param options 注水选项
- * @returns 注水结果汇总
- */
-export declare function hydrateAllIslands(options?: HydrationOptions): HydrateResult;
-/**
- * 注册 island 组件映射
- *
- * @param id        island 标识符
- * @param component 组件定义
- */
-export declare function registerIslandComponent(id: string, component: ComponentOptions): void;
-/**
- * 卸载 island
- *
- * 清理 island 的所有资源（事件监听、Observer、定时器等）。
- *
- * @param islandId island 标识符
- */
-export declare function unmountIsland(islandId: string): void;
-/**
- * 获取 island 注册表（测试用）
- */
-export declare function getIslandRegistry(): Map<string, IslandState>;
-/**
- * 清空 island 注册表（测试用）
- */
-export declare function clearIslandRegistry(): void;
-/**
- * 创建 Hydration Island 的服务端 HTML
- *
- * 生成带有 data-hydrate 属性和序列化 props 的 HTML，
- * 以及关联的 `<script type="application/json">` props 标签。
- *
- * @param component 组件定义
- * @param props     组件 props
- * @param tag       包裹标签名（默认 "div"）
- * @param hydrateWhen 注水策略（"visible" | "idle" | "interaction"）
- * @returns 完整的 island HTML 字符串
- *
- * @example
- *   createHydrationIsland(
- *     { name: 'counter', render: (props) => ({ type: 'span', ... }) },
- *     { initialCount: 0 },
- *   )
- *   // → <div data-hydrate="counter" data-props="{&quot;initialCount&quot;:0}">
- *   //      <span>Count: 0</span>
- *   //    </div>
- *   //    <script type="application/json" data-hydrate-props="counter">
- *   //      {"initialCount":0}
- *   //    </script>
- */
-export declare function createHydrationIsland(component: ComponentOptions, props?: Record<string, any>, tag?: string, hydrateWhen?: string): string;
-/** Mismatch 警告信息 */
-interface MismatchWarning {
-    /** island 标识符 */
-    islandId: string;
-    /** 期望的 HTML（客户端渲染） */
-    expected: string;
-    /** 实际的 HTML（服务端渲染） */
-    actual: string;
-    /** 修复建议 */
-    suggestion: string;
-}
-/**
- * 获取所有 mismatch 警告（测试用）
- */
-export declare function getMismatchWarnings(): MismatchWarning[];
-/**
- * 清空 mismatch 警告（测试用）
- */
-export declare function clearMismatchWarnings(): void;
-export {};
-//# sourceMappingURL=hydration.d.ts.map

package/dist/types/ssr/hydration.d.ts.map

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

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

@@ -1,15 +0,0 @@
-/**
- * Lyt.js SSR 渲染器 — 独立入口
- *
- * 仅包含服务端渲染（SSR）相关的 API。
- * 使用者可通过 `import '@lytjs/renderer/ssr'` 仅加载 SSR 渲染器。
- */
-export type { LytRenderer, RendererInstance } from '../renderer-interfaces';
-export type { VNode } from '../vnode';
-export { createRenderer, } from '../create-renderer';
-export { Fragment, Text, Comment, ShapeFlags, PatchFlags, } from '../vnode';
-export { StringRenderer, ssrRenderer, renderToString, renderToStream, renderToStreamGenerator } from './ssr-renderer';
-export type { SSRVNode, SSRTextVNode, ComponentOptions, RenderToStreamOptions } from './ssr-renderer';
-export { hydrate, isHydrating, setHydrating, onHydrated, getHydrateStats, resetHydrateStats, hydrateIsland, hydrateAllIslands, createHydrationIsland, registerIslandComponent, unmountIsland, getIslandRegistry, clearIslandRegistry, getMismatchWarnings, clearMismatchWarnings, } from './hydration';
-export type { HydrateOptions, HydrateResult, ComponentOptions as IslandComponentOptions } from './hydration';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ssr/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EACL,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,UAAU,EACV,UAAU,GACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACtH,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGtG,OAAO,EACL,OAAO,EACP,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,IAAI,sBAAsB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -1,277 +0,0 @@
-/**
- * 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;
-}
-import { normalizeClass as _normalizeClass, normalizeStyle as _normalizeStyle } from '@lytjs/common';
-/** Re-export normalizeClass and normalizeStyle for external use */
-export { _normalizeClass as normalizeClass, _normalizeStyle as normalizeStyle };
-/**
- * 重置 Suspense 边界 ID 计数器
- *
- * 在服务端渲染多个独立页面时调用，避免 ID 跨请求泄漏。
- */
-export declare function resetSuspenseBoundaryId(): void;
-/**
- * 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;
-/**
- * 序列化所有属性
- *
- * 将 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

@@ -1 +0,0 @@
-{"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

@@ -1,16 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * Lyt.js Vapor Mode — 独立入口
- *
- * 仅包含 Vapor Mode 相关的 API（无虚拟 DOM，直接操作真实 DOM）。
- * 使用者可通过 `import '@lytjs/renderer/vapor'` 仅加载 Vapor 渲染器。
- */
-export type { LytRenderer, RendererInstance } from '../renderer-interfaces';
-export type { VNode } from '../vnode';
-export { createRenderer, } from '../create-renderer';
-export { Fragment, Text, Comment, ShapeFlags, PatchFlags, } from '../vnode';
-export { createVaporElement, renderVaporNode, vaporPatch, vaporMount, setVaporDOMFactory, getVaporDOMFactory, } from './vapor-renderer';
-export type { VaporNode, VaporBinding, VaporBindingType, VaporContainer, VaporComponentOptions, VaporApp, VaporElement, BindingCleanup, } from './vapor-renderer';
-export { bindText, bindProp, bindAttr, bindClass, bindEvent, bindIf, bindEach, bindStyle, bindHTML, } from './vapor-reactive';
-export { compileToVapor, parseTemplate, } from './vapor-compiler';
-export type { VaporRenderFunction, VaporCompileResult } from './vapor-compiler';
-export { defineVaporComponent, createVaporApp, renderVaporComponent, } from './vapor-component';
-export type { VaporComponentInstance } from './vapor-component';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vapor/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGtC,OAAO,EACL,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,UAAU,EACV,UAAU,GACX,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,QAAQ,EACR,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEhF,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC"}