@viewfly/core 1.0.0-alpha.2 → 1.0.0-alpha.21

package/bundles/foundation/component.d.ts

@@ -1,245 +0,0 @@
-import { AbstractType, ExtractValueType, InjectFlags, InjectionToken, Injector, Provider, ReflectiveInjector, Type } from '../di/_api';
-import { Key, Props } from './jsx-element';
-import { ComponentView } from './_utils';
-/**
- * Viewfly 组件管理类，用于管理组件的生命周期，上下文等
- */
-export declare class Component extends ReflectiveInjector {
-    private readonly parentComponent;
-    readonly type: JSXInternal.ComponentSetup;
-    props: Props;
-    readonly key?: Key | undefined;
-    instance: JSXInternal.ComponentInstance<Props>;
-    template: JSXInternal.ViewNode;
-    changedSubComponents: Set<Component>;
-    get dirty(): boolean;
-    get changed(): boolean;
-    $$view: ComponentView;
-    unmountedCallbacks?: LifeCycleCallback[] | null;
-    mountCallbacks?: LifeCycleCallback[] | null;
-    propsChangedCallbacks?: PropsChangedCallback<any>[] | null;
-    updatedCallbacks?: LifeCycleCallback[] | null;
-    private updatedDestroyCallbacks?;
-    private propsChangedDestroyCallbacks?;
-    protected _dirty: boolean;
-    protected _changed: boolean;
-    private unWatch?;
-    private isFirstRendering;
-    private refs;
-    constructor(parentComponent: Injector | null, type: JSXInternal.ComponentSetup, props: Props, key?: Key | undefined);
-    markAsDirtied(): void;
-    markAsChanged(changedComponent?: Component): void;
-    render(): {
-        template: any;
-        portalHost: import("./injection-tokens").NativeNode | undefined;
-    };
-    update(newProps: Props, forceUpdate?: boolean): any;
-    provide<T>(providers: Provider<T> | Provider<T>[]): void;
-    rendered(): void;
-    destroy(): void;
-    private invokePropsChangedHooks;
-    private invokeMountHooks;
-    private invokeUpdatedHooks;
-}
-export interface LifeCycleCallback {
-    (): void | (() => void);
-}
-export interface PropsChangedCallback<T extends Props> {
-    (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>(callback: PropsChangedCallback<T>): () => void;
-/**
- * 当组件销毁时调用回调函数
- * @param callback
- */
-export declare function onUnmounted(callback: () => void): void;
-export interface RefListener<T> {
-    (current: T): void | (() => void);
-}
-export type ExtractInstanceType<T, U = T extends (...args: any) => any ? ReturnType<T> : T> = U extends JSXInternal.ComponentInstance<any> ? Omit<U, keyof JSXInternal.ComponentInstance<any>> : U extends Function ? never : T;
-export interface AbstractInstanceType<T extends Record<string, any>> {
-    (): T & JSXInternal.ComponentInstance<any>;
-}
-export declare class DynamicRef<T> {
-    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 = createDynamicRef(node => {
- *     function fn() {
- *       // do something...
- *     }
- *     node.addEventListener('click', fn)
- *     return () => {
- *       node.removeEventListener('click', fn)
- *     }
- *   })
- *   return () => {
- *     return <div ref={ref}>xxx</div>
- *   }
- * }
- * ```
- */
-export declare function createDynamicRef<T, U = ExtractInstanceType<T>>(callback: RefListener<U>): DynamicRef<U>;
-export declare class StaticRef<T> extends DynamicRef<T> {
-    readonly current: T | null;
-    constructor();
-}
-export declare function createRef<T, U = ExtractInstanceType<T>>(): StaticRef<U>;
-declare const depsKey: unique symbol;
-/**
- * 组件状态实例，直接调用可以获取最新的状态，通过 set 方法可以更新状态
- * ```
- */
-export interface Signal<T> {
-    $isSignal: true;
-    /**
-     *  直接调用一个 Signal 实例，可以获取最新状态
-     */
-    (): T;
-    /**
-     * 更新组件状态的方法，可以传入最新的值
-     * @param newState
-     */
-    set(newState: T): void;
-    [depsKey]: Set<LifeCycleCallback>;
-}
-/**
- * 组件状态管理器
- * @param state 初始状态
- * @example
- * ```tsx
- * function App() {
- *   // 初始化状态
- *   const state = createSignal(1)
- *
- *   return () => {
- *     <div>
- *       <div>当前值为：{state()}</div>
- *       <div>
- *         <button type="button" onClick={() => {
- *           // 当点击时更新状态
- *           state.set(state() + 1)
- *         }
- *         }>updateState</button>
- *       </div>
- *     </div>
- *   }
- * }
- */
-export declare function createSignal<T>(state: T): Signal<T>;
-/**
- * 使用派生值，Viewfly 会收集回调函数内同步执行时访问的 Signal，
- * 并在你获取 useDerived 函数返回的 Signal 的值时，自动计算最新的值。
- *
- * @param callback
- * @param isContinue 可选的停止函数，在每次值更新后调用，当返回值为 false 时，将不再监听依赖的变化
- */
-export declare function createDerived<T>(callback: () => T, isContinue?: (data: T) => unknown): Signal<T>;
-export interface WatchCallback<T, U> {
-    (newValue: T, oldValue: U): void | (() => void);
-}
-/**
- * 监听状态变化，当任意一个状态发生变更时，触发回调。
- * watch 会返回一个取消监听的函数，调用此函数，可以取消监听。
- * 当在组件中调用时，组件销毁时会自动取消监听。
- * @param deps 依赖的状态 Signal，可以是一个 Signal，只可以一个数包含 Signal 的数组，或者是一个求值函数
- * @param callback 状态变更后的回调函数
- */
-export declare function watch<T>(deps: Signal<T>, callback: WatchCallback<T, T>): () => void;
-export declare function watch<T>(deps: [Signal<T>], callback: WatchCallback<[T], [T]>): () => void;
-export declare function watch<T, T1>(deps: [Signal<T>, Signal<T1>], callback: WatchCallback<[T, T1], [T, T1]>): () => void;
-export declare function watch<T, T1, T2>(deps: [Signal<T>, Signal<T1>, Signal<T2>], callback: WatchCallback<[T, T1, T2], [T, T1, T2]>): () => void;
-export declare function watch<T, T1, T2, T3>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>], callback: WatchCallback<[T, T1, T2, T3], [T, T1, T2, T3]>): () => void;
-export declare function watch<T, T1, T2, T3, T4>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>], callback: WatchCallback<[T, T1, T2, T3, T4], [T, T1, T2, T3, T4]>): () => void;
-export declare function watch<T, T1, T2, T3, T4, T5>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>, Signal<T5>], callback: WatchCallback<[T, T1, T2, T3, T4, T5], [T, T1, T2, T3, T4, T5]>): () => void;
-export declare function watch<T, T1, T2, T3, T4, T5, T6>(deps: [Signal<T>, Signal<T1>, Signal<T2>, Signal<T3>, Signal<T4>, Signal<T5>, Signal<T6>], callback: WatchCallback<[T, T1, T2, T3, T4, T5, T6], [T, T1, T2, T3, T4, T5, T6]>): () => void;
-export declare function watch<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>], callback: WatchCallback<[T, T1, T2, T3, T4, T5, T6, T7], [T, T1, T2, T3, T4, T5, T6, T7]>): () => void;
-export declare function watch<T>(deps: () => T, callback: WatchCallback<T, T>): () => void;
-export declare function watch<T = any>(deps: Signal<any>[], callback: WatchCallback<T[], T[]>): () => void;
-/**
- * 给组件添加注解
- * @param annotation
- * @param componentSetup
- * @example
- * ```ts
- * export customScope = new Scope('scopeName')
- * export const App = withAnnotation({
- *   scope: customScope,
- *   providers: [
- *     ExampleService
- *   ]
- * }, function(props: Props) {
- *   return () => {
- *     return <div>...</div>
- *   }
- * })
- * ```
- */
-export declare function withAnnotation<T extends JSXInternal.ComponentSetup>(annotation: JSXInternal.ComponentAnnotation, componentSetup: T): T;
-/**
- * 通过组件上下文获取 IoC 容器内数据的勾子方法
- */
-export declare function inject<T extends Type<any> | AbstractType<any> | InjectionToken<any>, U = never>(token: T, flags?: InjectFlags, notFoundValue?: U): ExtractValueType<T> | U;
-/**
- * 获取当前组件实例
- */
-export declare function getCurrentInstance(): Component;
-export {};

package/bundles/foundation/injection-tokens.d.ts

@@ -1,18 +0,0 @@
-export type NativeNode = Record<string, any>;
-export declare abstract class NativeRenderer<ElementNode = NativeNode, TextNode = NativeNode> {
-    abstract createElement(name: string, isSvg: boolean): ElementNode;
-    abstract createTextNode(textContent: string, isSvg: boolean): TextNode;
-    abstract setProperty(node: ElementNode, key: string, value: any, isSvg: boolean): void;
-    abstract appendChild(parent: ElementNode, newChild: ElementNode | TextNode, isSvg: boolean): void;
-    abstract prependChild(parent: ElementNode, newChild: ElementNode | TextNode, isSvg: boolean): void;
-    abstract removeProperty(node: ElementNode, key: string, isSvg: boolean): void;
-    abstract setStyle(target: ElementNode, key: string, value: any, isSvg: boolean): void;
-    abstract removeStyle(target: ElementNode, key: string, isSvg: boolean): void;
-    abstract setClass(target: ElementNode, value: string, isSvg: boolean): void;
-    abstract listen<T = any>(node: ElementNode, type: string, callback: (ev: T) => any, isSvg: boolean): void;
-    abstract unListen(node: ElementNode, type: string, callback: (ev: any) => any, isSvg: boolean): void;
-    abstract remove(node: ElementNode | TextNode, isSvg: boolean): void;
-    abstract cleanChildren(node: ElementNode, isSvg: boolean): void;
-    abstract syncTextContent(target: TextNode, content: string, isSvg: boolean): void;
-    abstract insertAfter(newNode: ElementNode | TextNode, ref: ElementNode | TextNode, isSvg: boolean): void;
-}

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

@@ -1,19 +0,0 @@
-import { ListenDelegate } from './_utils';
-export interface Props {
-    children?: JSXInternal.ViewNode | JSXInternal.ViewNode[];
-    [key: string]: any;
-    [key: symbol]: any;
-}
-export declare function Fragment(props: Props): () => any;
-export type Key = number | string;
-export declare function jsx(type: string | JSXInternal.ComponentSetup, props: Props, key?: Key): JSXNode;
-export declare const jsxs: typeof jsx;
-export interface JSXNode<T = string | JSXInternal.ComponentSetup> {
-    type: T;
-    props: Props;
-    key?: Key;
-    on?: Record<string, ListenDelegate>;
-}
-export declare const JSXNodeFactory: {
-    createNode<T = string | JSXInternal.ComponentSetup<any>>(type: T, props: Props, key?: Key): JSXNode<T>;
-};

package/bundles/foundation/memo.d.ts

@@ -1,2 +0,0 @@
-import { Props } from './jsx-element';
-export declare function withMemo<T extends Props = Props>(canUseMemo: JSXInternal.ComponentInstance<T>['$useMemo'], render: () => JSXInternal.ViewNode): JSXInternal.ComponentInstance<T>;

package/bundles/foundation/renderer.d.ts

@@ -1,3 +0,0 @@
-import { NativeNode, NativeRenderer } from './injection-tokens';
-import { Component } from './component';
-export declare function createRenderer(component: Component, nativeRenderer: NativeRenderer): (host: NativeNode) => void;

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

@@ -1,10 +0,0 @@
-import { Component } from './component';
-import { Injector } from '../di/_api';
-/**
- * Viewfly 根组件，用于实现组件状态更新事件通知
- */
-export declare class RootComponent extends Component {
-    private refresh;
-    constructor(parentInjector: Injector | null, factory: JSXInternal.ComponentSetup, refresh: () => void);
-    markAsChanged(changedComponent?: Component): void;
-}

package/bundles/foundation/types.d.ts

@@ -1,43 +0,0 @@
-import { Key } from './jsx-element';
-import { ExtractInstanceType, DynamicRef } from './component';
-import { Scope } from '../di/injectable';
-import { NativeNode } from './injection-tokens';
-import { Provider } from '../di/provider';
-export type ViewNode = JSXInternal.ViewNode;
-declare global {
-    namespace JSXInternal {
-        type ClassNames = string | Record<string, unknown> | false | null | undefined | ClassNames[];
-        interface ComponentInstance<P> {
-            $portalHost?: NativeNode;
-            $render(): ViewNode;
-            $useMemo?(currentProps: P, prevProps: P): boolean;
-        }
-        type ViewNode = Element | JSXInternal.ElementClass | string | number | boolean | null | undefined | Iterable<ViewNode>;
-        interface ComponentAnnotation {
-            scope?: Scope;
-            providers?: Provider[];
-        }
-        interface ComponentSetup<P = any> {
-            (props: P): (() => ViewNode) | ComponentInstance<P>;
-            annotation?: ComponentAnnotation;
-        }
-        type Element<P = any, C extends string | ComponentSetup<P> = string | ComponentSetup<P>> = C extends string ? IntrinsicElements[C] : (() => Element) | ComponentInstance<P>;
-        interface IntrinsicAttributes {
-            key?: Key;
-            ref?: any;
-        }
-        interface RefAttributes<T> extends IntrinsicAttributes {
-            ref?: DynamicRef<ExtractInstanceType<T>> | DynamicRef<ExtractInstanceType<T>>[];
-        }
-        interface ElementClass<P = any> extends ComponentInstance<P> {
-        }
-        interface ElementChildrenAttribute {
-        }
-        interface IntrinsicElements {
-            [name: string]: any;
-        }
-        interface IntrinsicClassAttributes<T> {
-            ref?: DynamicRef<T>;
-        }
-    }
-}

package/bundles/public-api.d.ts

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

package/bundles/viewfly.d.ts

@@ -1,29 +0,0 @@
-import type { Provider } from './di/_api';
-import { NativeNode, NativeRenderer } from './foundation/_api';
-import { Injector } from './di/_api';
-/**
- * Viewfly 配置项
- */
-export interface Config {
-    /** 根节点 */
-    root: JSXInternal.ViewNode;
-    /** 平台渲染器 */
-    nativeRenderer: NativeRenderer;
-    /** 应用的上下文 */
-    context?: Injector;
-    /** 是否自动更新视图 */
-    autoUpdate?: boolean;
-}
-export interface Application<T extends NativeNode = NativeNode> {
-    provide(providers: Provider | Provider[]): Application<T>;
-    mount(host: T): Application<T>;
-    use(module: Module | Module[]): Application<T>;
-    render(): Application<T>;
-    destroy(): void;
-}
-export interface Module {
-    setup?(app: Application): void;
-    onAfterStartup?(app: Application): void;
-    onDestroy?(): void;
-}
-export declare function viewfly<T extends NativeNode>(config: Config): Application<T>;