@lytjs/component 3.1.0

package/dist/types/props.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Lyt.js Props 系统
+ *
+ * 提供 props 声明标准化、验证与初始化能力。
+ * 支持数组形式和对象形式的 props 声明，
+ * 支持类型检查、默认值（值 / 工厂函数）、required 校验。
+ * 纯原生实现，零外部依赖。
+ */
+/** 支持的 prop 原始类型构造器 */
+export type PropType = typeof String | typeof Number | typeof Boolean | typeof Array | typeof Object | typeof Function;
+/** 单个 prop 的声明选项 */
+export interface PropOptions {
+    /** 期望类型，可以是单个类型或类型数组 */
+    type?: PropType | PropType[] | null;
+    /** 是否必传，默认 false */
+    required?: boolean;
+    /** 默认值，可以是静态值或返回默认值的工厂函数 */
+    default?: any;
+    /** 自定义验证函数，返回 true 表示通过 */
+    validator?: (value: any) => boolean;
+}
+/** 标准化后的 props 选项映射 */
+export type NormalizedPropsOptions = Record<string, PropOptions>;
+/** 标准化后的 props 选项（保留原始 key 顺序） */
+export type NormalizedProps = {
+    /** 标准化后的选项映射 */
+    options: NormalizedPropsOptions;
+    /** 原始 key 列表（保持声明顺序） */
+    keys: string[];
+};
+/**
+ * 标准化 props 声明
+ *
+ * 支持两种形式：
+ * - 数组形式：['title', 'count']  → 每个元素转为 { type: null }
+ * - 对象形式：{ title: String, count: { type: Number, default: 0 } }
+ *
+ * @param props - 组件 options 中传入的 props 声明
+ * @returns 标准化后的 props 结构（options + keys）
+ */
+export declare function normalizePropsOptions(props: string[] | Record<string, PropOptions | PropType | PropType[]> | undefined | null): NormalizedProps;
+/**
+ * 验证单个 prop 值是否符合声明约束
+ *
+ * 检查顺序：
+ * 1. required 校验
+ * 2. type 校验（如果声明了 type）
+ * 3. 自定义 validator 校验
+ *
+ * @param propName - prop 名称
+ * @param propOptions - 该 prop 的标准化选项
+ * @param value - 传入的 prop 值
+ * @returns 验证是否通过
+ */
+export declare function validateProp(propName: string, propOptions: PropOptions, value: unknown): boolean;
+/**
+ * 获取 prop 的默认值
+ *
+ * 如果 default 是工厂函数则调用并返回结果，
+ * 否则直接返回 default 值。
+ *
+ * @param propOptions - 该 prop 的标准化选项
+ * @param propName - prop 名称（用于错误提示）
+ * @returns 默认值
+ */
+export declare function getPropDefaultValue(propOptions: PropOptions, propName: string): any;
+/**
+ * 初始化组件 props
+ *
+ * 流程：
+ * 1. 遍历标准化后的 props keys
+ * 2. 从 rawProps 中取值，没有则取默认值
+ * 3. 对 Boolean 类型做特殊转换
+ * 4. 执行 validateProp 校验
+ * 5. 将最终值写入 instance.props
+ *
+ * @param instance - 组件内部实例（需有 props 和 propsOptions 属性）
+ * @param rawProps - 父组件传入的原始 props
+ * @returns 初始化后的 props 对象
+ */
+export declare function initProps(instance: {
+    props: Record<string, any>;
+    propsOptions: NormalizedProps;
+}, rawProps: Record<string, any> | null | undefined): Record<string, any>;
+//# 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;;;;;;;GAOG;AAMH,uBAAuB;AACvB,MAAM,MAAM,QAAQ,GAChB,OAAO,MAAM,GACb,OAAO,MAAM,GACb,OAAO,OAAO,GACd,OAAO,KAAK,GACZ,OAAO,MAAM,GACb,OAAO,QAAQ,CAAC;AAEpB,oBAAoB;AACpB,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC;IACpC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,2BAA2B;IAC3B,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC;CACrC;AAED,uBAAuB;AACvB,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEjE,kCAAkC;AAClC,MAAM,MAAM,eAAe,GAAG;IAC5B,gBAAgB;IAChB,OAAO,EAAE,sBAAsB,CAAC;IAChC,wBAAwB;IACxB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAmGF;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GACvF,eAAe,CAsDjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,OAAO,GACb,OAAO,CAwET;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,MAAM,GACf,GAAG,CAuBL;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAAC,YAAY,EAAE,eAAe,CAAA;CAAE,EACvE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,SAAS,GAC/C,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAmCrB"}

package/dist/types/signal-state.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Lyt.js Signal State Adapter
+ *
+ * 将普通状态对象转换为基于 Signal 的响应式状态。
+ * 提供 Proxy 包装，使组件代码可以使用 this.count 而非 this.count.value()。
+ * 纯原生零依赖实现。
+ */
+import { type WritableSignal } from '@lytjs/reactivity/signal';
+/** Signal 状态对象：每个 key 对应一个 WritableSignal */
+export type SignalState = Record<string, WritableSignal<any>>;
+/** Signal 状态代理（自动解包/设置 Signal 值） */
+export type SignalStateProxy = Record<string, any>;
+/**
+ * 将普通状态对象转换为 Signal-based 状态
+ *
+ * 例如：createSignalState({ count: 0, name: 'hello' })
+ * 返回：{ count: signal(0), name: signal('hello') }
+ *
+ * @param initialState - 初始状态对象
+ * @returns 每个字段对应一个 WritableSignal 的对象
+ */
+export declare function createSignalState(initialState: Record<string, any>): SignalState;
+/**
+ * 创建 Signal 状态代理
+ *
+ * 代理对象会自动解包 Signal 值（读取时调用 sig()），
+ * 并自动设置 Signal 值（写入时调用 sig.set(value)）。
+ *
+ * 这允许组件代码使用 this.count 而非 this.count.value()。
+ *
+ * @param signalState - Signal 状态对象
+ * @returns 代理对象
+ */
+export declare function createSignalStateProxy(signalState: SignalState): SignalStateProxy;
+/**
+ * 获取 Signal 状态的原始值快照
+ *
+ * @param signalState - Signal 状态对象
+ * @returns 包含所有 Signal 当前值的普通对象
+ */
+export declare function getSignalStateSnapshot(signalState: SignalState): Record<string, any>;
+/**
+ * 批量更新 Signal 状态
+ *
+ * @param signalState - Signal 状态对象
+ * @param partial - 要更新的部分状态
+ */
+export declare function patchSignalState(signalState: SignalState, partial: Record<string, any>): void;
+/**
+ * 清理 Signal 状态（停止所有 Signal 的订阅）
+ *
+ * 注意：当前 Signal 实现没有显式的 dispose 方法，
+ * 此函数为未来扩展预留。
+ *
+ * @param signalState - Signal 状态对象
+ */
+export declare function disposeSignalState(signalState: SignalState): void;
+//# sourceMappingURL=signal-state.d.ts.map

package/dist/types/signal-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-state.d.ts","sourceRoot":"","sources":["../../src/signal-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,0BAA0B,CAAA;AAMjC,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAA;AAE7D,oCAAoC;AACpC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAMlD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CAQhF;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,gBAAgB,CAwDjF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CASpF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAS7F;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAGjE"}

package/dist/types/slots.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Lyt.js 插槽系统
+ *
+ * 提供组件插槽的初始化、标准化与访问能力。
+ * 支持默认插槽、具名插槽和作用域插槽。
+ * 纯原生实现，零外部依赖。
+ */
+/**
+ * 插槽内容类型
+ *
+ * 插槽内容可以是：
+ * - 普通值（字符串、数字等）
+ * - 返回 VNode / 内容的函数（作用域插槽）
+ * - VNode 数组
+ * - null / undefined（空插槽）
+ */
+export type SlotValue = any | ((...args: any[]) => any) | null | undefined;
+/** 插槽映射表：插槽名 → 插槽内容 */
+export type Slots = Record<string, SlotValue>;
+/** 子节点结构，用于传递插槽内容 */
+export interface SlotChildren {
+    /** 默认插槽内容 */
+    default?: SlotValue;
+    /** 具名插槽内容 */
+    [name: string]: SlotValue | undefined;
+}
+/** 组件实例所需的最小插槽接口 */
+export interface SlotsInstance {
+    /** 初始化后的插槽映射 */
+    slots: Slots;
+}
+/**
+ * 标准化插槽内容
+ *
+ * 将各种形式的插槽内容统一处理：
+ * - null / undefined → 返回 null（空插槽）
+ * - 函数 → 保持原样（作用域插槽，调用时传入 props）
+ * - 数组 → 保持原样（多个子节点）
+ * - 其他值 → 包装为数组（单个子节点）
+ *
+ * @param value - 原始插槽内容
+ * @returns 标准化后的插槽内容
+ */
+export declare function normalizeSlotValue(value: SlotValue): SlotValue;
+/**
+ * 初始化组件插槽
+ *
+ * 从 children 中提取插槽内容并标准化。
+ * children 可以是：
+ * - null / undefined → 无插槽
+ * - 函数 → 默认作用域插槽
+ * - 数组 → 默认插槽内容（多个子节点）
+ * - 普通对象 → 具名插槽映射
+ *
+ * @param instance - 组件实例（需有 slots 属性）
+ * @param children - 父组件传入的子节点 / 插槽内容
+ * @returns 初始化后的插槽映射
+ */
+export declare function initSlots(instance: SlotsInstance, children: SlotChildren | SlotValue | null | undefined): Slots;
+/**
+ * 渲染插槽
+ *
+ * 获取指定名称的插槽内容并渲染。
+ * 如果是作用域插槽（函数），传入 scope 参数调用。
+ *
+ * @param slots - 插槽映射
+ * @param name - 插槽名称（默认为 'default'）
+ * @param scope - 传递给作用域插槽的数据
+ * @returns 插槽渲染结果，如果没有对应插槽则返回 null
+ */
+export declare function renderSlot(slots: Slots, name?: string, scope?: any): any;
+/**
+ * 检查插槽是否存在
+ *
+ * @param slots - 插槽映射
+ * @param name - 插槽名称（默认为 'default'）
+ * @returns 插槽是否存在且有内容
+ */
+export declare function hasSlot(slots: Slots, name?: string): boolean;
+//# sourceMappingURL=slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/slots.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GACjB,GAAG,GACH,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GACzB,IAAI,GACJ,SAAS,CAAC;AAEd,uBAAuB;AACvB,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE9C,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,aAAa;IACb,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,aAAa;IACb,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;CACvC;AAED,oBAAoB;AACpB,MAAM,WAAW,aAAa;IAC5B,gBAAgB;IAChB,KAAK,EAAE,KAAK,CAAC;CACd;AAwBD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAkB9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GAAG,SAAS,GACpD,KAAK,CA4CP;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,KAAK,EACZ,IAAI,GAAE,MAAkB,EACxB,KAAK,CAAC,EAAE,GAAG,GACV,GAAG,CAcL;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAGvE"}

package/dist/types/src/builtins/async-component.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Lyt.js defineAsyncComponent - 异步组件定义
+ *
+ * 定义异步加载的组件，支持加载状态、错误处理、超时和重试。
+ * 可配合 Suspense 组件使用（suspensible 模式）。
+ * 纯原生实现，零外部依赖。
+ */
+import { type ComponentDefine } from '../define-component';
+/** 异步组件配置选项 */
+export interface AsyncComponentOptions {
+    /** 异步加载函数，返回 Promise<ComponentDefine | ComponentOptions> */
+    loader: () => Promise<any>;
+    /** 加载中显示的组件 */
+    loadingComponent?: any;
+    /** 加载失败显示的组件 */
+    errorComponent?: any;
+    /** 延迟显示 loading 的时间(ms)，默认 200 */
+    delay?: number;
+    /** 超时时间(ms)，超时后显示 errorComponent */
+    timeout?: number;
+    /** 错误回调 */
+    onError?: (error: Error, retry: () => void, fail: () => void) => void;
+    /** 是否配合 Suspense 使用，默认 true */
+    suspensible?: boolean;
+    /** 重试次数上限，默认 3 */
+    retryCount?: number;
+}
+/**
+ * 定义异步组件
+ *
+ * 返回一个包装组件，首次渲染时调用 loader 异步加载真实组件。
+ * 加载过程中可显示 loadingComponent，加载失败显示 errorComponent。
+ *
+ * @param options - 异步组件配置选项，或直接传入 loader 函数
+ * @returns 异步组件定义（ComponentDefine）
+ *
+ * @example
+ * ```ts
+ * // 简单用法：传入 loader 函数
+ * const AsyncComp = defineAsyncComponent(() => import('./MyComponent'));
+ *
+ * // 完整配置
+ * const AsyncComp = defineAsyncComponent({
+ *   loader: () => import('./MyComponent'),
+ *   loadingComponent: LoadingSpinner,
+ *   errorComponent: ErrorDisplay,
+ *   delay: 200,          // 200ms 后才显示 loading
+ *   timeout: 10000,      // 10s 超时
+ *   onError(error, retry, fail) {
+ *     if (error.message.includes('network')) {
+ *       retry();         // 网络错误时重试
+ *     } else {
+ *       fail();          // 其他错误直接失败
+ *     }
+ *   },
+ *   suspensible: true,   // 配合 Suspense 使用
+ * });
+ * ```
+ */
+export declare function defineAsyncComponent(options: AsyncComponentOptions | (() => Promise<any>)): ComponentDefine;
+//# sourceMappingURL=async-component.d.ts.map

package/dist/types/src/builtins/async-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-component.d.ts","sourceRoot":"","sources":["../../../../src/builtins/async-component.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,qBAAqB,CAAC;AAM7B,eAAe;AACf,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,eAAe;IACf,gBAAgB,CAAC,EAAE,GAAG,CAAC;IACvB,gBAAgB;IAChB,cAAc,CAAC,EAAE,GAAG,CAAC;IACrB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACtE,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GACpD,eAAe,CAiQjB"}

package/dist/types/src/builtins/error-boundary.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lyt.js ErrorBoundary 内置错误边界组件
+ *
+ * 捕获子组件渲染错误，显示降级 UI（fallback slot），
+ * 支持 onError 回调和错误状态管理。
+ * 支持同步和异步错误捕获、错误计数自动禁用、开发模式错误详情。
+ * 纯原生实现，零外部依赖。
+ */
+import { type ComponentDefine } from '../define-component';
+/** ErrorBoundary 组件的 Props 接口 */
+export interface ErrorBoundaryProps {
+    /** 降级 UI 内容（错误时显示） */
+    fallback?: any;
+    /** 最大错误记录数，默认 100 */
+    maxErrors?: number;
+    /** 错误回调 */
+    onError?: (error: Error, vm: any, info: string) => void;
+    /** 错误捕获回调，返回 true 阻止传播 */
+    onErrorCaptured?: (error: Error, vm: any, info: string) => boolean | void;
+    /** 错误状态变化回调 */
+    onErrorChange?: (hasError: boolean, error: Error | null) => void;
+    /** 重置回调（用户触发重置时调用） */
+    onReset?: () => void;
+    /** 自动禁用的最大错误次数，默认 Infinity（不自动禁用） */
+    maxErrorCount?: number;
+}
+export declare const ErrorBoundaryComponent: ComponentDefine;
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/types/src/builtins/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../../../src/builtins/error-boundary.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAA;AAM5B,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,GAAG,CAAA;IACd,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACvD,0BAA0B;IAC1B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI,CAAA;IACzE,eAAe;IACf,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAA;IAChE,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAcD,eAAO,MAAM,sBAAsB,EAAE,eAuNnC,CAAA"}

package/dist/types/src/builtins/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Lyt.js 内置组件 — 统一导出入口
+ *
+ * 导出所有内置组件和工具函数。
+ * 纯原生实现，零外部依赖。
+ */
+export { Transition, TransitionPropsKeys } from './transition';
+export type { TransitionProps } from './transition';
+export { TransitionGroup } from './transition-group';
+export type { TransitionGroupProps } from './transition-group';
+export { KeepAlive, pruneCacheEntry, pruneCache, registerKeepAliveInstance, attachCacheRef } from './keep-alive';
+export type { KeepAliveProps } from './keep-alive';
+export { Suspense } from './suspense';
+export type { SuspenseProps } from './suspense';
+export { ErrorBoundaryComponent } from './error-boundary';
+export type { ErrorBoundaryProps } from './error-boundary';
+export { defineAsyncComponent } from './async-component';
+export type { AsyncComponentOptions } from './async-component';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/builtins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/builtins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjH,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types/src/builtins/keep-alive.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Lyt.js KeepAlive 内置缓存组件
+ *
+ * 缓存组件实例，避免重复渲染和销毁。
+ * 支持 include/exclude 匹配规则和 max LRU 淘汰策略。
+ * 提供 activated/deactivated 生命周期钩子。
+ * 纯原生实现，零外部依赖。
+ */
+import { type ComponentDefine, type ComponentInternalInstance } from '../define-component';
+/** KeepAlive 组件的 Props 接口 */
+export interface KeepAliveProps {
+    /** 匹配的组件名缓存（字符串精确匹配或 RegExp 正则匹配） */
+    include?: string | RegExp | (string | RegExp)[];
+    /** 匹配的组件名不缓存 */
+    exclude?: string | RegExp | (string | RegExp)[];
+    /** 最大缓存数量，超过时使用 LRU 淘汰策略 */
+    max?: number;
+}
+/** 缓存条目 */
+interface CacheEntry {
+    /** 缓存的 VNode（原始引用，非拷贝） */
+    vnode: any;
+    /** 缓存的组件实例 */
+    component: ComponentInternalInstance | null;
+    /** 缓存的 key（组件名） */
+    key: string;
+    /** 组件实例的完整状态快照（deactivate 时保存） */
+    savedState: SavedComponentState | null;
+}
+/** 组件实例状态快照 */
+interface SavedComponentState {
+    /** 组件内部 state（reactive 对象的原始值） */
+    state: Record<string, any>;
+    /** 组件 setupState */
+    setupState: Record<string, any>;
+    /** 计算属性引用（@lyt/reactivity ComputedRef） */
+    computedRefs: Record<string, {
+        value: any;
+    } | (() => any)>;
+    /** 子树 */
+    subTree: any;
+    /** 是否已挂载 */
+    isMounted: boolean;
+    /** watch 停止句柄列表 */
+    watchStopHandles: any[];
+    /** 生命周期钩子快照 */
+    lifecycleHooks: Partial<Record<string, any[]>>;
+}
+/**
+ * KeepAlive 内置缓存组件
+ *
+ * 缓存包裹的组件实例，切换时不会销毁组件而是移入缓存，
+ * 再次切换回来时从缓存恢复，避免重复创建和销毁。
+ *
+ * 缓存策略：
+ * - include：只有匹配的组件会被缓存
+ * - exclude：匹配的组件不会被缓存
+ * - max：最大缓存数量，使用 LRU（最近最少使用）策略淘汰
+ *
+ * 生命周期：
+ * - activated：从缓存恢复时触发
+ * - deactivated：移入缓存时触发
+ *
+ * @example
+ * ```ts
+ * // 基本用法
+ * <keep-alive>
+ *   <component :is="currentComponent" />
+ * </keep-alive>
+ *
+ * // 配置 include/exclude
+ * <keep-alive include="Home" exclude="Login" :max="10">
+ *   <component :is="currentComponent" />
+ * </keep-alive>
+ * ```
+ */
+export declare const KeepAlive: ComponentDefine;
+/**
+ * 注册组件实例到 KeepAlive 缓存
+ *
+ * 当 KeepAlive 包裹的子组件完成挂载后，
+ * 渲染器应调用此方法将组件实例关联到对应的缓存条目。
+ *
+ * @param vnode - 子组件的 VNode
+ * @param component - 子组件的内部实例
+ */
+export declare function registerKeepAliveInstance(vnode: any, component: ComponentInternalInstance): void;
+/**
+ * 将缓存 Map 引用关联到 VNode
+ *
+ * 在 KeepAlive render 时调用，使 registerKeepAliveInstance
+ * 能找到正确的缓存 Map。
+ *
+ * @param vnode - 子组件 VNode
+ * @param cache - KeepAlive 的缓存 Map
+ */
+export declare function attachCacheRef(vnode: any, cache: Map<string, CacheEntry>): void;
+/**
+ * 淘汰指定缓存条目
+ *
+ * 从缓存中移除指定 key 的条目，
+ * 并触发该组件的 deactivated 钩子。
+ *
+ * @param cache - 缓存 Map
+ * @param key - 要淘汰的缓存 key
+ */
+export declare function pruneCacheEntry(cache: Map<string, CacheEntry>, key: string): void;
+/**
+ * 根据 include/exclude 规则清理缓存
+ *
+ * 遍历所有缓存条目，移除不满足条件的条目。
+ *
+ * @param cache - 缓存 Map
+ * @param props - KeepAlive props
+ */
+export declare function pruneCache(cache: Map<string, CacheEntry>, props: KeepAliveProps): void;
+export {};
+//# sourceMappingURL=keep-alive.d.ts.map

package/dist/types/src/builtins/keep-alive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-alive.d.ts","sourceRoot":"","sources":["../../../../src/builtins/keep-alive.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAa7B,6BAA6B;AAC7B,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAChD,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAChD,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,WAAW;AACX,UAAU,UAAU;IAClB,0BAA0B;IAC1B,KAAK,EAAE,GAAG,CAAC;IACX,cAAc;IACd,SAAS,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAC5C,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,kCAAkC;IAClC,UAAU,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACxC;AAED,eAAe;AACf,UAAU,mBAAmB;IAC3B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3D,SAAS;IACT,OAAO,EAAE,GAAG,CAAC;IACb,YAAY;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB;IACnB,gBAAgB,EAAE,GAAG,EAAE,CAAC;IACxB,eAAe;IACf,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;CAChD;AA0KD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,SAAS,EAAE,eAiItB,CAAC;AAMH;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,yBAAyB,GACnC,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,GAAG,EACV,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GAC7B,IAAI,CAIN;AAiDD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,IAAI,CAWN;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAC9B,KAAK,EAAE,cAAc,GACpB,IAAI,CAaN"}

package/dist/types/src/builtins/suspense.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Lyt.js Suspense 内置异步依赖等待组件
+ *
+ * 等待异步子组件加载完成后再显示真实内容，
+ * 加载过程中显示 fallback 占位内容。
+ * 支持多个异步子组件（全部完成后才切换），
+ * 支持超时处理和事件回调。
+ * 纯原生实现，零外部依赖。
+ */
+import { type ComponentDefine } from '../define-component';
+/** Suspense 组件的 Props 接口 */
+export interface SuspenseProps {
+    /** 异步加载时显示的占位内容 */
+    fallback?: any;
+    /** 超时时间(ms)，超时后显示 fallback */
+    timeout?: number;
+    /** 等待开始回调 */
+    onPending?: () => void;
+    /** 异步组件全部加载完成回调 */
+    onResolve?: () => void;
+    /** 显示 fallback 回调 */
+    onFallback?: () => void;
+}
+/**
+ * Suspense 内置异步依赖等待组件
+ *
+ * 等待所有异步子组件加载完成后再显示真实内容。
+ * 加载过程中显示 fallback 占位内容。
+ *
+ * 工作流程：
+ * 1. 检测子组件是否为异步组件
+ * 2. 如果有异步组件，显示 fallback
+ * 3. 等待所有异步组件加载完成
+ * 4. 全部完成后切换为真实内容
+ * 5. 如果超时，显示 fallback 并触发超时处理
+ *
+ * @example
+ * ```ts
+ * // 基本用法
+ * <suspense :fallback="LoadingSpinner">
+ *   <async-component />
+ * </suspense>
+ *
+ * // 带超时
+ * <suspense :fallback="LoadingSpinner" :timeout="3000" :onResolve="handleLoaded">
+ *   <async-component />
+ * </suspense>
+ * ```
+ */
+export declare const Suspense: ComponentDefine;
+//# sourceMappingURL=suspense.d.ts.map

package/dist/types/src/builtins/suspense.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspense.d.ts","sourceRoot":"","sources":["../../../../src/builtins/suspense.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAM7B,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAiHD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,QAAQ,EAAE,eAgOrB,CAAC"}

package/dist/types/src/builtins/transition-group.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Lyt.js TransitionGroup 内置列表过渡组件
+ *
+ * 继承 Transition 的所有功能，额外处理列表中元素的移动过渡（FLIP 动画技术）。
+ * 使用 getBoundingClientRect 记录元素位置，在 DOM 更新后计算位移并应用 transform 动画。
+ * 纯原生实现，零外部依赖。
+ */
+import { type ComponentDefine } from '../define-component';
+import { type TransitionProps } from './transition';
+/** TransitionGroup 组件的 Props 接口 */
+export interface TransitionGroupProps extends TransitionProps {
+    /** 包裹标签名，默认不渲染包裹元素（Fragment） */
+    tag?: string;
+    /** 移动过渡类名 */
+    moveClass?: string;
+}
+/**
+ * TransitionGroup 内置列表过渡组件
+ *
+ * 处理列表中多个子元素的进入、离开和移动过渡。
+ * 继承 Transition 的 CSS 类名和 JS 钩子功能，
+ * 额外使用 FLIP 技术实现元素移动动画。
+ *
+ * @example
+ * ```ts
+ * // 列表过渡
+ * <transition-group name="list" tag="ul">
+ *   <li v-for="item in items" :key="item.id">
+ *     {{ item.text }}
+ *   </li>
+ * </transition-group>
+ *
+ * // CSS 示例
+ * // .list-enter-active, .list-leave-active { transition: all 0.3s; }
+ * // .list-enter-from, .list-leave-to { opacity: 0; transform: translateX(30px); }
+ * // .list-move { transition: transform 0.3s; }
+ * ```
+ */
+export declare const TransitionGroup: ComponentDefine;
+//# sourceMappingURL=transition-group.d.ts.map

package/dist/types/src/builtins/transition-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-group.d.ts","sourceRoot":"","sources":["../../../../src/builtins/transition-group.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,eAAe,EAMrB,MAAM,cAAc,CAAC;AAMtB,mCAAmC;AACnC,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,eAAe,EAAE,eAwI5B,CAAC"}