@lytjs/component 3.1.0

package/dist/types/composition-api.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Lyt.js Composition API
+ *
+ * 提供 setup() 函数式组件编写能力，包括：
+ * - 生命周期钩子（onMounted / onUnmounted / onUpdated / onBeforeMount / onBeforeUnmount）
+ * - 依赖注入（provide / inject）
+ * - setup 执行器（runSetup）
+ * - 当前实例访问（getCurrentInstance）
+ *
+ * 纯原生实现，零外部依赖。
+ */
+/** 生命周期钩子回调函数类型 */
+type LifecycleHook = () => void;
+/** setup 函数类型 */
+export type SetupFunction = (props: any, ctx: any) => object | Function;
+/**
+ * 注册挂载完成钩子
+ *
+ * 在组件挂载到 DOM 后调用。必须在 setup() 函数内调用。
+ *
+ * @param hook - 钩子回调函数
+ */
+export declare function onMounted(hook: LifecycleHook): void;
+/**
+ * 注册卸载完成钩子
+ *
+ * 在组件从 DOM 移除后调用。必须在 setup() 函数内调用。
+ *
+ * @param hook - 钩子回调函数
+ */
+export declare function onUnmounted(hook: LifecycleHook): void;
+/**
+ * 注册更新完成钩子
+ *
+ * 在组件响应式数据变化导致 DOM 更新后调用。必须在 setup() 函数内调用。
+ *
+ * @param hook - 钩子回调函数
+ */
+export declare function onUpdated(hook: LifecycleHook): void;
+/**
+ * 注册挂载前钩子
+ *
+ * 在组件挂载到 DOM 前调用。必须在 setup() 函数内调用。
+ *
+ * @param hook - 钩子回调函数
+ */
+export declare function onBeforeMount(hook: LifecycleHook): void;
+/**
+ * 注册卸载前钩子
+ *
+ * 在组件从 DOM 移除前调用。必须在 setup() 函数内调用。
+ *
+ * @param hook - 钩子回调函数
+ */
+export declare function onBeforeUnmount(hook: LifecycleHook): void;
+/**
+ * 提供依赖
+ *
+ * 在祖先组件的 setup() 中调用，为后代组件提供数据。
+ *
+ * @param key - 依赖的唯一标识
+ * @param value - 要提供的值
+ *
+ * @example
+ * ```ts
+ * setup(props, ctx) {
+ *   provide('theme', 'dark')
+ *   provide('config', reactive({ debug: true }))
+ * }
+ * ```
+ */
+export declare function provide<T>(key: string | symbol, value: T): void;
+/**
+ * 注入依赖
+ *
+ * 在后代组件的 setup() 中调用，从祖先组件查找并获取提供的数据。
+ * 沿着组件实例的 _parent 链向上查找，直到找到匹配的 key 或到达根组件。
+ *
+ * @param key - 依赖的唯一标识
+ * @param defaultValue - 找不到时的默认值（可选）
+ * @returns 注入的值或默认值
+ *
+ * @example
+ * ```ts
+ * setup(props, ctx) {
+ *   const theme = inject<string>('theme')          // 'dark'
+ *   const config = inject('config', { debug: false }) // 使用默认值
+ * }
+ * ```
+ */
+export declare function inject<T>(key: string | symbol, defaultValue?: T): T | undefined;
+/**
+ * 执行 setup 函数
+ *
+ * 在组件初始化阶段调用，设置当前实例上下文后执行用户定义的 setup 函数。
+ * setup 可以返回：
+ * - 对象：属性合并到组件上下文（renderProxy）
+ * - 函数：作为组件的渲染函数
+ *
+ * @param setupFn - 用户定义的 setup 函数
+ * @param instance - 组件内部实例
+ * @param props - 组件 props
+ * @param ctx - 组件上下文（包含 attrs、slots、emit 等）
+ * @returns setup 返回值（对象或函数）
+ */
+export declare function runSetup(setupFn: Function, instance: any, props: any, ctx: any): any;
+/**
+ * 获取当前正在执行的 setup 对应的组件实例
+ *
+ * 只能在 setup() 执行期间调用，其他时候返回 null。
+ *
+ * @returns 当前组件实例或 null
+ */
+export declare function getCurrentInstance(): any;
+export {};
+//# sourceMappingURL=composition-api.d.ts.map

package/dist/types/composition-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-api.d.ts","sourceRoot":"","sources":["../../src/composition-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,mBAAmB;AACnB,KAAK,aAAa,GAAG,MAAM,IAAI,CAAA;AAE/B,iBAAiB;AACjB,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,MAAM,GAAG,QAAQ,CAAA;AAavE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMnD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMrD;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMnD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMvD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAMzD;AASD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAS/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAY/E;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,CAQpF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,GAAG,CAExC"}

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

@@ -0,0 +1,265 @@
+/**
+ * Lyt.js 组件定义系统
+ *
+ * 提供组件定义（defineComponent）、内部实例创建与初始化能力。
+ * 支持有状态组件（选项式）和函数组件两种模式。
+ * 基于 @lytjs/reactivity 响应式系统实现 computed 和 watch。
+ */
+import { type WatchStopHandle } from '@lytjs/reactivity';
+import { type SignalState } from './signal-state';
+import { type NormalizedProps, type PropOptions, type PropType } from './props';
+import { type NormalizedEmitsOptions, type EmitsOptions } from './emit';
+import { type LifecycleInstance } from './lifecycle';
+import { type Slots, type SlotChildren } from './slots';
+import { type SetupFunction } from './composition-api';
+/** 组件渲染函数类型 */
+export type RenderFunction = (h: CreateElement, instance: ComponentInternalInstance) => any;
+/** 简易 createElement 函数类型 */
+export type CreateElement = (tag: string | Function, props?: Record<string, any>, children?: any[]) => any;
+/** 计算属性定义 */
+export interface ComputedOptions {
+    [key: string]: (() => any) | {
+        /** 计算属性的 getter */
+        get: () => any;
+        /** 计算属性的 setter（可选） */
+        set?: (value: any) => void;
+    };
+}
+/** 侦听器选项 */
+export interface WatchOptions {
+    [key: string]: {
+        /** 要侦听的状态/props 路径 */
+        handler: (newValue: any, oldValue: any) => void;
+        /** 是否立即执行 */
+        immediate?: boolean;
+        /** 是否深度侦听 */
+        deep?: boolean;
+    };
+}
+/** 响应式模式 */
+export type ReactivityMode = 'proxy' | 'signal';
+/** 组件选项（选项式 API） */
+export interface ComponentOptions {
+    /** 组件名称 */
+    name?: string;
+    /** Props 声明 */
+    props?: string[] | Record<string, PropOptions | PropType | PropType[]>;
+    /** 组件内部状态（响应式数据） */
+    state?: () => Record<string, any>;
+    /** 计算属性 */
+    computed?: ComputedOptions;
+    /** 侦听器 */
+    watch?: WatchOptions;
+    /** 方法 */
+    methods?: Record<string, (...args: any[]) => any>;
+    /** 模板字符串 */
+    template?: string;
+    /** 渲染函数（优先于 template） */
+    render?: RenderFunction;
+    /** 初始化函数（setup 阶段调用） */
+    init?: (this: ComponentPublicInstance, props: Record<string, any>, state: Record<string, any>) => void | Record<string, any>;
+    /** Composition API setup 函数 */
+    setup?: SetupFunction;
+    /** Emits 声明 */
+    emits?: EmitsOptions;
+    /** 默认插槽内容（由父组件传入） */
+    slots?: SlotChildren;
+    /** 响应式模式：'proxy'（默认，基于 Proxy）或 'signal'（基于 Signal） */
+    reactivityMode?: ReactivityMode;
+}
+/** 函数组件类型 */
+export type FunctionalComponent = (props: Record<string, any>, context: {
+    slots: Slots;
+    emit: EmitFunction;
+}) => any;
+/** emit 函数类型 */
+export type EmitFunction = (event: string, ...args: any[]) => boolean;
+/** 组件公共实例（对外暴露给用户的接口） */
+export interface ComponentPublicInstance {
+    /** 组件名称 */
+    $name?: string;
+    /** 组件 props（只读） */
+    $props: Record<string, any>;
+    /** 组件内部状态 */
+    $state: Record<string, any>;
+    /** 组件插槽 */
+    $slots: Slots;
+    /** 组件是否已挂载 */
+    $isMounted: boolean;
+    /** 触发事件 */
+    $emit: EmitFunction;
+    /** 强制更新 */
+    $forceUpdate: () => void;
+    /** 卸载组件 */
+    $unmount: () => void;
+    /** 设置状态 */
+    $setState: (partial: Record<string, any>) => void;
+}
+/** 组件内部实例（框架内部使用） */
+export interface ComponentInternalInstance extends LifecycleInstance {
+    /** 组件类型标记 */
+    _isComponent: true;
+    /** 组件定义选项 */
+    type: ComponentOptions;
+    /** 组件名称 */
+    name?: string;
+    /** 标准化后的 props 选项 */
+    propsOptions: NormalizedProps;
+    /** 标准化后的 emits 选项 */
+    emitsOptions?: NormalizedEmitsOptions;
+    /** 组件 props */
+    props: Record<string, any>;
+    /** 组件内部状态（proxy 模式为 shallowReactive，signal 模式为 SignalStateProxy） */
+    state: Record<string, any>;
+    /** Signal 模式下的原始 Signal 状态（仅 signal 模式存在） */
+    _signalState?: SignalState;
+    /** setup 返回的状态（合并到 renderProxy） */
+    setupState: Record<string, any>;
+    /** 计算属性缓存（使用 @lytjs/reactivity 的 ComputedRef） */
+    computedRefs: Record<string, {
+        value: any;
+    } | (() => any)>;
+    /** 渲染代理（公共实例，用户通过 this 访问） */
+    renderProxy: ComponentPublicInstance;
+    /** 渲染结果子树 */
+    subTree: any;
+    /** 是否已挂载 */
+    isMounted: boolean;
+    /** 是否已卸载 */
+    isUnmounted: boolean;
+    /** 组件插槽 */
+    slots: Slots;
+    /** watch 停止句柄列表（用于卸载时清理） */
+    watchStopHandles: WatchStopHandle[];
+    /** emit 函数的绑定引用 */
+    emit: EmitFunction;
+    /** 更新回调（由渲染器设置） */
+    update?: () => void;
+    /** Composition API 生命周期钩子 */
+    _lifecycleHooks?: Record<string, Function[]>;
+}
+/** defineComponent 的返回类型 */
+export interface ComponentDefine {
+    /** 组件名称 */
+    name?: string;
+    /** 组件选项 */
+    options: ComponentOptions;
+    /** 标记为组件定义 */
+    _isComponentDefine: true;
+}
+/**
+ * 定义组件（选项式 API）
+ *
+ * 接收组件选项对象，返回标准化的组件定义。
+ * 支持的选项：
+ * - name: 组件名称
+ * - props: 属性声明（数组或对象形式）
+ * - state: 响应式数据工厂函数
+ * - computed: 计算属性
+ * - watch: 侦听器
+ * - methods: 方法
+ * - template: 模板字符串
+ * - render: 渲染函数
+ * - init: 初始化函数
+ * - emits: 事件声明
+ * - slots: 默认插槽
+ *
+ * @param options - 组件选项
+ * @returns 组件定义对象
+ *
+ * @example
+ * ```ts
+ * const MyComponent = defineComponent({
+ *   name: 'MyComponent',
+ *   props: {
+ *     title: { type: String, default: 'Hello' },
+ *     count: { type: Number, required: true }
+ *   },
+ *   state() {
+ *     return { inner: 0 };
+ *   },
+ *   methods: {
+ *     increment() {
+ *       this.$setState({ inner: this.$state.inner + 1 });
+ *     }
+ *   },
+ *   init(props, state) {
+ *     console.log('组件初始化', props.title);
+ *   }
+ * });
+ * ```
+ */
+export declare function defineComponent(options: ComponentOptions): ComponentDefine;
+/**
+ * 创建组件内部实例
+ *
+ * 根据组件定义创建内部实例对象，但不执行初始化。
+ *
+ * @param component - 组件定义
+ * @returns 组件内部实例
+ */
+export declare function createComponentInstance(component: ComponentDefine): ComponentInternalInstance;
+/**
+ * 初始化组件
+ *
+ * 根据组件类型执行不同的初始化流程：
+ * - 有状态组件（ComponentOptions）→ setupStatefulComponent
+ * - 函数组件（Function）→ setupFunctionComponent
+ *
+ * @param instance - 组件内部实例
+ * @param rawProps - 父组件传入的原始 props
+ * @param children - 父组件传入的子节点 / 插槽
+ */
+export declare function setupComponent(instance: ComponentInternalInstance, rawProps?: Record<string, any> | null, children?: SlotChildren | null): void;
+/**
+ * 有状态组件初始化
+ *
+ * 初始化流程：
+ * 1. 设置当前实例上下文
+ * 2. 初始化 state（调用 state 工厂函数）
+ * 3. 初始化 computed（标记为脏）
+ * 4. 初始化 methods（绑定到 renderProxy）
+ * 5. 调用 init 函数（用户自定义初始化逻辑）
+ * 6. 将 methods 和 setupState 合并到 renderProxy
+ * 7. 调用 onInit 生命周期钩子
+ * 8. 恢复之前的实例上下文
+ *
+ * @param instance - 组件内部实例
+ */
+export declare function setupStatefulComponent(instance: ComponentInternalInstance): void;
+/**
+ * 函数组件初始化
+ *
+ * 函数组件没有内部状态，直接将 props 和 slots 传递给渲染函数。
+ *
+ * @param instance - 组件内部实例
+ */
+export declare function setupFunctionComponent(instance: ComponentInternalInstance): void;
+/**
+ * 挂载组件
+ *
+ * 调用渲染函数生成子树，标记为已挂载，触发 onMounted 钩子。
+ *
+ * @param instance - 组件内部实例
+ * @param h - createElement 函数（可选，用于渲染函数）
+ */
+export declare function mountComponent(instance: ComponentInternalInstance, h?: CreateElement): void;
+/**
+ * 更新组件
+ *
+ * 触发 beforeUpdate → 重新渲染 → updated 生命周期。
+ *
+ * @param instance - 组件内部实例
+ * @param h - createElement 函数
+ * @param newProps - 新的 props（可选）
+ */
+export declare function updateComponent(instance: ComponentInternalInstance, h?: CreateElement, newProps?: Record<string, any>): void;
+/**
+ * 卸载组件
+ *
+ * 触发 beforeUnmount → 标记已卸载 → unmounted 生命周期。
+ *
+ * @param instance - 组件内部实例
+ */
+export declare function unmountComponent(instance: ComponentInternalInstance): void;
+//# sourceMappingURL=define-component.d.ts.map

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

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

package/dist/types/emit.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Lyt.js 事件发射系统
+ *
+ * 提供组件自定义事件的声明、标准化与发射能力。
+ * 支持驼峰命名自动转短横线、emits 声明校验。
+ * 纯原生实现，零外部依赖。
+ */
+/** emits 声明形式：字符串数组或带验证器的对象 */
+export type EmitsOptions = string[] | Record<string, ((...args: any[]) => boolean) | null>;
+/** 标准化后的 emits 配置 */
+export interface NormalizedEmitsOptions {
+    /** 已声明的事件名集合（短横线形式） */
+    keys: string[];
+    /** 事件名 → 验证函数映射（无验证器则为 null） */
+    validators: Record<string, ((...args: any[]) => boolean) | null>;
+}
+/** 组件实例所需的最小 emit 接口 */
+export interface EmitInstance {
+    /** 组件的 emits 声明（标准化后） */
+    emitsOptions?: NormalizedEmitsOptions;
+    /** 组件注册的事件处理函数映射（key 为短横线形式） */
+    props?: Record<string, any>;
+}
+/**
+ * 将驼峰命名转为短横线命名
+ *
+ * 示例：
+ * - handleChange → change
+ * - updateValue → update-value
+ * - myCustomEvent → my-custom-event
+ *
+ * @param str - 驼峰命名的字符串
+ * @returns 短横线命名的字符串
+ */
+export declare function camelizeToHyphen(str: string): string;
+/**
+ * 将短横线命名转为驼峰命名
+ *
+ * 示例：
+ * - update-value → updateValue
+ * - my-custom-event → myCustomEvent
+ *
+ * @param str - 短横线命名的字符串
+ * @returns 驼峰命名的字符串
+ */
+export declare function hyphenToCamel(str: string): string;
+/**
+ * 标准化 emits 声明
+ *
+ * 支持两种形式：
+ * - 数组形式：['change', 'update'] → 每个事件无验证器
+ * - 对象形式：{ change: null, update: (val) => val > 0 } → 可附带验证器
+ *
+ * 所有事件名统一转为短横线形式。
+ *
+ * @param emits - 组件 options 中传入的 emits 声明
+ * @returns 标准化后的 emits 配置
+ */
+export declare function normalizeEmits(emits: EmitsOptions | undefined | null): NormalizedEmitsOptions;
+/**
+ * 组件事件发射
+ *
+ * 流程：
+ * 1. 将事件名转为短横线形式
+ * 2. 如果组件声明了 emits，校验事件是否已声明
+ * 3. 如果该事件有验证器，执行验证
+ * 4. 在实例 props 中查找对应的处理函数并调用
+ *
+ * 事件处理函数命名约定：
+ * - 事件 "change" 对应处理函数 "onChange"
+ * - 事件 "update-value" 对应处理函数 "onUpdateValue"
+ *
+ * @param instance - 组件实例
+ * @param event - 事件名（支持驼峰或短横线形式）
+ * @param args - 传递给事件处理函数的参数
+ * @returns 事件是否有对应的处理函数被调用
+ */
+export declare function emit(instance: EmitInstance, event: string, ...args: any[]): boolean;
+//# sourceMappingURL=emit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/emit.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AAE3F,qBAAqB;AACrB,MAAM,WAAW,sBAAsB;IACrC,uBAAuB;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CAClE;AAED,wBAAwB;AACxB,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AA2BD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GACrC,sBAAsB,CAmCxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAClB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,OAAO,CAqDT"}

package/dist/types/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Lyt.js 组件系统 — 统一导出入口
+ *
+ * 导出所有公共 API 和类型定义。
+ * 纯原生实现，零外部依赖。
+ */
+export { defineComponent, createComponentInstance, setupComponent, setupStatefulComponent, setupFunctionComponent, mountComponent, updateComponent, unmountComponent, } from './define-component';
+export type { ComponentOptions, ComponentDefine, ComponentPublicInstance, ComponentInternalInstance, RenderFunction, CreateElement, ComputedOptions, WatchOptions, FunctionalComponent, EmitFunction, ReactivityMode, } from './define-component';
+export { normalizePropsOptions, validateProp, initProps, getPropDefaultValue, } from './props';
+export type { PropType, PropOptions, NormalizedPropsOptions, NormalizedProps, } from './props';
+export { emit, normalizeEmits, camelizeToHyphen, hyphenToCamel, } from './emit';
+export type { EmitsOptions, NormalizedEmitsOptions, EmitInstance, } from './emit';
+export { LifecycleHook, createLifecycleHook, callLifecycleHook, setCurrentInstance, onInit, onMounted, onBeforeUpdate, onUpdated, onBeforeUnmount, onUnmounted, currentInstance, } from './lifecycle';
+export type { LifecycleHookCallback, LifecycleInstance, } from './lifecycle';
+export { initSlots, normalizeSlotValue, renderSlot, hasSlot, } from './slots';
+export type { SlotValue, Slots, SlotChildren, SlotsInstance, } from './slots';
+export { Transition, TransitionGroup, KeepAlive, Suspense, defineAsyncComponent, } from './builtins';
+export type { TransitionProps, TransitionGroupProps, KeepAliveProps, SuspenseProps, AsyncComponentOptions, } from './builtins';
+export { onMounted as compositionOnMounted, onUnmounted as compositionOnUnmounted, onUpdated as compositionOnUpdated, onBeforeMount as compositionOnBeforeMount, onBeforeUnmount as compositionOnBeforeUnmount, provide, inject, getCurrentInstance, runSetup, } from './composition-api';
+export type { SetupFunction, } from './composition-api';
+export { createSignalState, createSignalStateProxy, getSignalStateSnapshot, patchSignalState, disposeSignalState, } from './signal-state';
+export type { SignalState, SignalStateProxy, } from './signal-state';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,yBAAyB,EACzB,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,SAAS,EACT,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,sBAAsB,EACtB,eAAe,GAChB,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,IAAI,EACJ,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,YAAY,GACb,MAAM,QAAQ,CAAC;AAMhB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,EACN,SAAS,EACT,cAAc,EACd,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,UAAU,EACV,OAAO,GACR,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,SAAS,EACT,KAAK,EACL,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AAMjB,OAAO,EACL,UAAU,EACV,eAAe,EACf,SAAS,EACT,QAAQ,EACR,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,SAAS,IAAI,oBAAoB,EACjC,WAAW,IAAI,sBAAsB,EACrC,SAAS,IAAI,oBAAoB,EACjC,aAAa,IAAI,wBAAwB,EACzC,eAAe,IAAI,0BAA0B,EAC7C,OAAO,EACP,MAAM,EACN,kBAAkB,EAClB,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,aAAa,GACd,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,WAAW,EACX,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/types/lifecycle.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Lyt.js 生命周期系统
+ *
+ * 提供组件生命周期钩子的注册、管理与调用能力。
+ * 支持 onInit / onMounted / onBeforeUpdate / onUpdated / onBeforeUnmount / onUnmounted。
+ * 包含当前实例管理（currentInstance / setCurrentInstance），
+ * 可在 setup 阶段自动收集生命周期钩子。
+ * 纯原生实现，零外部依赖。
+ */
+/** 生命周期钩子名称枚举 */
+export declare enum LifecycleHook {
+    /** 初始化阶段（组件实例创建后，props/state 初始化完成） */
+    INIT = "init",
+    /** 挂载完成（组件首次渲染到 DOM 后） */
+    MOUNTED = "mounted",
+    /** 更新前（响应式数据变化后，DOM 更新前） */
+    BEFORE_UPDATE = "beforeUpdate",
+    /** 更新完成（DOM 更新后） */
+    UPDATED = "updated",
+    /** 卸载前（组件从 DOM 移除前） */
+    BEFORE_UNMOUNT = "beforeUnmount",
+    /** 卸载完成（组件从 DOM 移除后） */
+    UNMOUNTED = "unmounted"
+}
+/** 生命周期钩子回调函数类型 */
+export type LifecycleHookCallback = (...args: any[]) => void;
+/** 组件实例所需的最小生命周期接口 */
+export interface LifecycleInstance {
+    /** 生命周期钩子注册表：hookName → 回调函数数组 */
+    [LifecycleHook.INIT]?: LifecycleHookCallback[];
+    [LifecycleHook.MOUNTED]?: LifecycleHookCallback[];
+    [LifecycleHook.BEFORE_UPDATE]?: LifecycleHookCallback[];
+    [LifecycleHook.UPDATED]?: LifecycleHookCallback[];
+    [LifecycleHook.BEFORE_UNMOUNT]?: LifecycleHookCallback[];
+    [LifecycleHook.UNMOUNTED]?: LifecycleHookCallback[];
+}
+/** 当前正在初始化的组件实例 */
+export declare let currentInstance: LifecycleInstance | null;
+/**
+ * 设置当前正在初始化的组件实例
+ *
+ * 在组件 setup 阶段调用，使生命周期钩子能自动注册到正确的实例。
+ *
+ * @param instance - 组件实例，传 null 表示退出 setup 上下文
+ * @returns 之前的当前实例（用于嵌套场景恢复）
+ */
+export declare function setCurrentInstance(instance: LifecycleInstance | null): LifecycleInstance | null;
+/**
+ * 创建生命周期钩子注册函数
+ *
+ * 返回一个函数，调用该函数即可注册对应生命周期的回调。
+ * 如果当前有 activeInstance，回调注册到该实例；
+ * 否则注册到指定的 target 实例。
+ *
+ * @param hook - 生命周期钩子名称
+ * @returns 钩子注册函数
+ *
+ * @example
+ * ```ts
+ * const onMounted = createLifecycleHook(LifecycleHook.MOUNTED);
+ *
+ * // 在 setup 中使用
+ * onMounted(() => {
+ *   console.log('组件已挂载');
+ * });
+ * ```
+ */
+export declare function createLifecycleHook(hook: LifecycleHook): (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+/**
+ * 调用组件的生命周期钩子
+ *
+ * 按注册顺序依次执行指定生命周期名称下的所有回调。
+ * 如果某个回调抛出异常，会捕获并警告，但不影响后续回调执行。
+ *
+ * @param instance - 组件实例
+ * @param hook - 要调用的生命周期钩子名称
+ * @param args - 传递给回调函数的参数
+ */
+export declare function callLifecycleHook(instance: LifecycleInstance, hook: LifecycleHook, ...args: any[]): void;
+/** 注册初始化钩子 */
+export declare const onInit: (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+/** 注册挂载完成钩子 */
+export declare const onMounted: (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+/** 注册更新前钩子 */
+export declare const onBeforeUpdate: (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+/** 注册更新完成钩子 */
+export declare const onUpdated: (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+/** 注册卸载前钩子 */
+export declare const onBeforeUnmount: (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+/** 注册卸载完成钩子 */
+export declare const onUnmounted: (callback: LifecycleHookCallback, target?: LifecycleInstance) => void;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,iBAAiB;AACjB,oBAAY,aAAa;IACvB,uCAAuC;IACvC,IAAI,SAAS;IACb,0BAA0B;IAC1B,OAAO,YAAY;IACnB,4BAA4B;IAC5B,aAAa,iBAAiB;IAC9B,oBAAoB;IACpB,OAAO,YAAY;IACnB,uBAAuB;IACvB,cAAc,kBAAkB;IAChC,wBAAwB;IACxB,SAAS,cAAc;CACxB;AAED,mBAAmB;AACnB,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAE7D,sBAAsB;AACtB,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC/C,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClD,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACxD,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClD,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzD,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACrD;AAED,mBAAmB;AACnB,eAAO,IAAI,eAAe,EAAE,iBAAiB,GAAG,IAAW,CAAC;AAiB5D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,iBAAiB,GAAG,IAAI,CAI1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,aAAa,GAClB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,iBAAiB,KAAK,IAAI,CA6BvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,aAAa,EACnB,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,IAAI,CAiBN;AAMD,cAAc;AACd,eAAO,MAAM,MAAM,aArEL,qBAAqB,WAAW,iBAAiB,KAAK,IAqEP,CAAC;AAE9D,eAAe;AACf,eAAO,MAAM,SAAS,aAxER,qBAAqB,WAAW,iBAAiB,KAAK,IAwED,CAAC;AAEpE,cAAc;AACd,eAAO,MAAM,cAAc,aA3Eb,qBAAqB,WAAW,iBAAiB,KAAK,IA2EU,CAAC;AAE/E,eAAe;AACf,eAAO,MAAM,SAAS,aA9ER,qBAAqB,WAAW,iBAAiB,KAAK,IA8ED,CAAC;AAEpE,cAAc;AACd,eAAO,MAAM,eAAe,aAjFd,qBAAqB,WAAW,iBAAiB,KAAK,IAiFY,CAAC;AAEjF,eAAe;AACf,eAAO,MAAM,WAAW,aApFV,qBAAqB,WAAW,iBAAiB,KAAK,IAoFG,CAAC"}