@viewfly/core 0.0.1-alpha.12 → 0.0.1-alpha.13

package/bundles/model/_api.d.ts

@@ -1,3 +0,0 @@
-export * from './component';
-export * from './jsx-element';
-export * from './root.component';

package/bundles/model/component.d.ts

@@ -1,218 +0,0 @@
-import { Provider, ReflectiveInjector, AbstractType, Type, InjectionToken, InjectFlags, Injector } from '@tanbo/di';
-import { Props, JSXElement, Key, JSXTypeof } from './jsx-element';
-export declare class JSXComponent {
-    createInstance: (injector: Component) => Component;
-    constructor(createInstance: (injector: Component) => Component);
-}
-export type JSXTemplate = JSXElement | JSXComponent | null | void;
-export interface ComponentSetup<T extends Props<any> = Props<any>> {
-    (props?: T): () => JSXTemplate;
-}
-/**
- * Viewfly 组件管理类，用于管理组件的生命周期，上下文等
- */
-export declare class Component extends ReflectiveInjector implements JSXTypeof {
-    setup: ComponentSetup;
-    props: Props<any>;
-    key?: Key | undefined;
-    $$typeOf: ComponentSetup<Props<any>>;
-    destroyCallbacks: LifeCycleCallback[];
-    mountCallbacks: LifeCycleCallback[];
-    propsChangedCallbacks: PropsChangedCallback<any>[];
-    updatedCallbacks: LifeCycleCallback[];
-    get dirty(): boolean;
-    get changed(): boolean;
-    protected _dirty: boolean;
-    protected _changed: boolean;
-    private parentComponent;
-    private updatedDestroyCallbacks;
-    private propsChangedDestroyCallbacks;
-    private isFirstRending;
-    constructor(context: Injector, setup: ComponentSetup, props: Props<any>, key?: Key | undefined);
-    is(target: JSXTypeof): boolean;
-    addProvide<T>(providers: Provider<T> | Provider<T>[]): void;
-    init(): {
-        template: JSXTemplate;
-        render: () => JSXTemplate;
-    };
-    markAsDirtied(): void;
-    markAsChanged(): void;
-    rendered(): void;
-    invokePropsChangedHooks(newProps: Props<any>): void;
-    destroy(): void;
-    private invokeMountHooks;
-    private invokeUpdatedHooks;
-}
-export interface LifeCycleCallback {
-    (): void | (() => void);
-}
-export interface PropsChangedCallback<T extends Props<any>> {
-    (currentProps: T | null, oldProps: T | null): void | (() => void);
-}
-/**
- * 当组件第一次渲染完成时触发
- * @param callback
- * ```tsx
- * function App() {
- *   onMount(() => {
- *     console.log('App mounted!')
- *   })
- *   return () => <div>...</div>
- * }
- * ```
- */
-export declare function onMounted(callback: LifeCycleCallback): void;
-/**
- * 当组件视图更新后调用
- * @param callback
- * ```tsx
- * function App() {
- *   onUpdated(() => {
- *     console.log('App updated!')
- *     return () => {
- *       console.log('destroy prev update!')
- *     }
- *   })
- *   return () => <div>...</div>
- * }
- * ```
- */
-export declare function onUpdated(callback: LifeCycleCallback): () => void;
-/**
- * 当组件 props 更新地调用
- * @param callback
- * @example
- * ```tsx
- * function YourComponent(props) {
- *   onPropsChanged((currentProps, prevProps) => {
- *     console.log(currentProps, prevProps)
- *
- *     return () => {
- *       console.log('destroy prev changed!')
- *     }
- *   })
- *   return () => {
- *     return <div>xxx</div>
- *   }
- * }
- * ```
- */
-export declare function onPropsChanged<T extends Props<any>>(callback: PropsChangedCallback<T>): () => void;
-/**
- * 当组件销毁时调用回调函数
- * @param callback
- */
-export declare function onDestroy(callback: () => void): void;
-export interface RefListener<T> {
-    (current: T): void | (() => void);
-}
-export declare class Ref<T extends object> {
-    private callback;
-    private unBindMap;
-    private targetCaches;
-    constructor(callback: RefListener<T>);
-    bind(value: T): void;
-    unBind(value: T): void;
-}
-/**
- * 用于节点渲染完成时获取 DOM 节点
- * @param callback 获取 DOM 节点的回调函数
- * @example
- * ```tsx
- * function App() {
- *   const ref = useRef(node => {
- *     function fn() {
- *       // do something...
- *     }
- *     node.addEventListener('click', fn)
- *     return () => {
- *       node.removeEventListener('click', fn)
- *     }
- *   })
- *   return () => {
- *     return <div ref={ref}>xxx</div>
- *   }
- * }
- * ```
- */
-export declare function useRef<T extends object>(callback: RefListener<T>): Ref<T>;
-declare const depsKey: unique symbol;
-/**
- * 组件状态实例，直接调用可以获取最新的状态，通过 set 方法可以更新状态
- * ```
- */
-export interface Signal<T> {
-    /**
-     *  直接调用一个 Signal 实例，可以获取最新状态
-     */
-    (): T;
-    /**
-     * 更新组件状态的方法，可以传入最新的值
-     * @param newState
-     */
-    set(newState: T): void;
-    [depsKey]: Set<LifeCycleCallback>;
-}
-/**
- * 组件状态管理器
- * @param state 初始状态
- * @example
- * ```tsx
- * function App() {
- *   // 初始化状态
- *   const state = useSignal(1)
- *
- *   return () => {
- *     <div>
- *       <div>当前值为：{state()}</div>
- *       <div>
- *         <button type="button" onClick={() => {
- *           // 当点击时更新状态
- *           state.set(state() + 1)
- *         }
- *         }>updateState</button>
- *       </div>
- *     </div>
- *   }
- * }
- */
-export declare function useSignal<T>(state: T): Signal<T>;
-/**
- * 使用派生值，Viewfly 会收集回调函数内同步执行时访问的 Signal，
- * 并在你获取 useDerived 函数返回的 Signal 的值时，自动计算最新的值。
- *
- * @param callback
- * @param isContinue 可选的停止函数，在每次值更新后调用，当返回值为 false 时，将不再监听依赖的变化
- */
-export declare function useDerived<T>(callback: () => T, isContinue?: (data: T) => unknown): Signal<T>;
-export interface EffectCallback<T, U> {
-    (newValue: T, oldValue: U): void | (() => void);
-}
-/**
- * 监听状态变化，当任意一个状态发生变更时，触发回调。
- * useEffect 会返回一个取消监听的函数，调用此函数，可以取消监听。
- * 当在组件中调用时，组件销毁时会自动取消监听。
- * @param deps 依赖的状态 Signal，可以是一个 Signal，只可以一个数包含 Signal 的数组，或者是一个求值函数
- * @param effect 状态变更后的回调函数
- */
-export declare function useEffect<T>(deps: Signal<T>, effect: EffectCallback<T, T>): () => void;
-export declare function useEffect<T>(deps: [Signal<T>], effect: EffectCallback<[T], [T]>): () => void;
-export declare function useEffect<T, T1>(deps: [Signal<T>, Signal<T1>], effect: EffectCallback<[T, T1], [T, T1]>): () => void;
-export declare function useEffect<T, T1, T2>(deps: [Signal<T>, Signal<T1>, Signal<T2>], effect: EffectCallback<[T, T1, T2], [T, T1, T2]>): () => void;
-export declare function useEffect<T, T1, T2, T3>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>], effect: EffectCallback<[T, T1, T2, T3], [T, T1, T2, T3]>): () => void;
-export declare function useEffect<T, T1, T2, T3, T4>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>], effect: EffectCallback<[T, T1, T2, T3, T4], [T, T1, T2, T3, T4]>): () => void;
-export declare function useEffect<T, T1, T2, T3, T4, T5>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>, Signal<T5>], effect: EffectCallback<[T, T1, T2, T3, T4, T5], [T, T1, T2, T3, T4, T5]>): () => void;
-export declare function useEffect<T, T1, T2, T3, T4, T5, T6>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>, Signal<T5>, Signal<T6>], effect: EffectCallback<[T, T1, T2, T3, T4, T5, T6], [T, T1, T2, T3, T4, T5, T6]>): () => void;
-export declare function useEffect<T, T1, T2, T3, T4, T5, T6, T7>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>, Signal<T5>, Signal<T6>, Signal<T7>], effect: EffectCallback<[T, T1, T2, T3, T4, T5, T6, T7], [T, T1, T2, T3, T4, T5, T6, T7]>): () => void;
-export declare function useEffect<T>(deps: () => T, effect: EffectCallback<T, T>): () => void;
-export declare function useEffect<T = any>(deps: Signal<any>[], effect: EffectCallback<T[], T[]>): () => void;
-/**
- * 通过 IoC 容器当前组件提供上下文共享数据的方法
- * @param provider
- */
-export declare function provide(provider: Provider | Provider[]): Component;
-/**
- * 通过组件上下文获取 IoC 容器内数据的勾子方法
- */
-export declare function inject<T>(token: Type<T> | AbstractType<T> | InjectionToken<T>, notFoundValue?: T, flags?: InjectFlags): T;
-export {};

package/bundles/model/jsx-element.d.ts

@@ -1,31 +0,0 @@
-import { JSXComponent, ComponentSetup } from './component';
-export type JSXChildNode = JSXElement | JSXComponent | string | number | boolean | null | undefined | JSXChildNode[];
-export interface Props<T = JSXChildNode | JSXChildNode[]> {
-    children?: T;
-    [key: string]: any;
-    [key: symbol]: any;
-}
-export declare const Fragment: () => never;
-export type Key = number | string;
-export declare function jsx<T extends JSXChildNode>(name: string, config: Props<T>, key?: Key): JSXElement;
-export declare function jsx<T extends JSXChildNode>(setup: ComponentSetup, config: Props<T>, key?: Key): JSXComponent;
-export declare function jsxs<T extends JSXChildNode[]>(name: string, config: Props<T>, key?: Key): JSXElement;
-export declare function jsxs<T extends JSXChildNode[]>(setup: ComponentSetup, config: Props<T>, key?: Key): JSXComponent;
-export interface JSXTypeof {
-    $$typeOf: string | ComponentSetup;
-    is(target: JSXTypeof): boolean;
-}
-export declare class JSXText implements JSXTypeof {
-    text: string;
-    $$typeOf: string;
-    constructor(text: string);
-    is(target: JSXTypeof): boolean;
-}
-export declare class JSXElement implements JSXTypeof {
-    name: string;
-    props: Props<any>;
-    key?: Key | undefined;
-    $$typeOf: string;
-    constructor(name: string, props: Props<any>, key?: Key | undefined);
-    is(target: JSXTypeof): boolean;
-}

package/bundles/model/root.component.d.ts

@@ -1,11 +0,0 @@
-import { Subject } from '@tanbo/stream';
-import { NullInjector } from '@tanbo/di';
-import { Component, ComponentSetup } from './component';
-/**
- * Viewfly 根组件，用于实现组件状态更新事件通知
- */
-export declare class RootComponent extends Component {
-    changeEmitter: Subject<void>;
-    constructor(factory: ComponentSetup, parentInjector?: NullInjector);
-    markAsChanged(): void;
-}

package/bundles/public-api.d.ts

@@ -1,6 +0,0 @@
-import 'reflect-metadata';
-export * from '@tanbo/di';
-export * from './_utils/make-error';
-export * from './foundation/_api';
-export * from './model/_api';
-export * from './viewfly';

package/bundles/viewfly.d.ts

@@ -1,37 +0,0 @@
-import { Injector, Provider, ReflectiveInjector } from '@tanbo/di';
-import { NativeNode } from './foundation/_api';
-import { JSXComponent, JSXElement } from './model/_api';
-export type RootNode = JSXElement | JSXComponent;
-/**
- * Viewfly 配置项
- */
-export interface Config {
-    /** Viewfly IoC 容器中提供者集合 */
-    providers?: Provider[];
-    /** 是否自动更新视图 */
-    autoUpdate?: boolean;
-    /** 根节点 */
-    root: RootNode;
-    /** 根组件的上下文 */
-    context?: Injector;
-}
-/**
- * Viewfly 核心类，用于启动一个 Viewfly 应用
- */
-export declare class Viewfly extends ReflectiveInjector {
-    private config;
-    private destroyed;
-    private rootComponent;
-    private subscription;
-    constructor(config: Config);
-    /**
-     * 启动 Viewfly
-     * @param host 应用根节点
-     */
-    mount(host: NativeNode): void;
-    /**
-     * 销毁 Viewfly 实例
-     */
-    destroy(): void;
-    private createRootComponent;
-}